DSH Image2 Draw

Unable to generate images directly in DeepSeek Harness? This plugin adds Image2 generation through a third-party relay that exposes an OpenAI Images-compatible API. Configure only a baseURL and an API Key, then use gpt-image-2 for text-to-image and image-to-image tasks in chat.

中文说明

Third-party service recommendation (referral link)

If you are looking for an OpenAI-compatible API relay, you can take a look at WPIronman API. This is my referral link, and I may receive a referral benefit if you register through it; any promotion or benefit is subject to the provider's current terms. This plugin is independent of that service and does not require any particular relay. Evaluate pricing, reliability, and privacy terms before choosing a provider.

Related project

Need independent reasoning-effort controls for third-party models in DeepSeek Harness? See my other plugin: DSH Reasoning Settings. It configures reasoning levels, provider defaults, and API wire values for custom providers and models.

Features

• Adds an Image2 Draw card under Settings > Plugins > Configurable plugins.
• Requires only a baseURL and an API Key; the default model is gpt-image-2.
• Accepts a short base URL such as https://example.com/v1 and appends /images/generations automatically.
• Derives the image-edit endpoint as /images/edits, with an optional explicit editURL override.
• Provides image2-generate for 1-8 sequential text-to-image generations.
• Provides image2-edit with 1-8 PNG, JPEG, or WebP reference images.
• Supports adaptive portrait, landscape, and square sizes as well as validated custom dimensions.
• Saves images under outputs/image2/ in the current session working directory and numbers duplicate names instead of overwriting files.
• Stores API keys only in DSH credentials. Keys never enter the regular settings document and are never returned by the plugin state endpoint.
• Validates settings writes, response sizes, timeouts, and input images. HTTP 524 and timeout failures are not retried automatically, preventing duplicate charges when the upstream service has already generated an image.

Installation

Prerequisites

• Install Node.js. DSH currently supports Node.js 22.19.x or version 24 and newer; Node.js 24 LTS is recommended. Node.js includes npm and npx.
• Install Git so the plugin can be fetched from GitHub.
• Install pnpm. Both methods require pnpm because dsh plugin invokes it in the profile directory to install or remove plugins.
• Your network must reach registry.npmjs.org and github.com. Configure a working network proxy if npm or GitHub is unavailable or unstable.
• Method 1 does not require a DeepSeek Harness source checkout. Method 2 additionally requires that checkout.

Check the basic environment first:

node --version
npx --version
git --version
corepack enable
pnpm --version

If corepack enable fails with a permission error, run it once from an Administrator PowerShell. Alternatively, use another option from the pnpm installation guide.

If downloads remain on a spinner or fail with ECONNRESET, ETIMEDOUT, or a GitHub connection error, set a proxy for the current PowerShell window. Port 7890 is only an example; replace it with your proxy's actual port:

$proxy = "http://127.0.0.1:7890"
$env:HTTP_PROXY = $proxy
$env:HTTPS_PROXY = $proxy
$env:npm_config_proxy = $proxy
$env:npm_config_https_proxy = $proxy

These variables only affect the current PowerShell window and disappear when it is closed.

Method 1: npx (recommended for regular users)

This method does not require a DeepSeek Harness source checkout or a global dsh installation, but Git and pnpm must already be available. On its first run, npx downloads @deepseek-ai/dsh and its dependencies, which can take several minutes:

npx --yes -p @deepseek-ai/dsh dsh plugin --profile web add github:JuneLearn/dsh-image2-draw

Start Web through the same package runner after installation:

npx --yes -p @deepseek-ai/dsh dsh web

Method 2: pnpm with the Harness source tree (recommended for developers)

Use this method if you already cloned deepseek-harness and want to run its source directly. First confirm pnpm is available:

pnpm --version

Enter the DeepSeek Harness source root. Install its dependencies once, then install the plugin:

cd D:\deepseek-harness
pnpm install
pnpm dsh plugin --profile web add github:JuneLearn/dsh-image2-draw

Start Web from that source directory afterward:

cd D:\deepseek-harness
pnpm dsh web

The package's dsh.bundle declaration adds the plugin to the Web profile automatically. Neither method requires editing cordis.patch.yml. Web listens on http://127.0.0.1:3080 by default; it uses another port only when the default is occupied or you explicitly select one.

Upgrade

Run the corresponding install command again to upgrade. No uninstall or profile-patch maintenance is required.

npx method:

npx --yes -p @deepseek-ai/dsh dsh plugin --profile web add github:JuneLearn/dsh-image2-draw

pnpm source method:

cd D:\deepseek-harness
pnpm dsh plugin --profile web add github:JuneLearn/dsh-image2-draw

Uninstall

npx method:

npx --yes -p @deepseek-ai/dsh dsh plugin --profile web remove dsh-image2-draw

pnpm source method:

cd D:\deepseek-harness
pnpm dsh plugin --profile web remove dsh-image2-draw

DSH removes both the dependency and its bundle layer. Restart dsh web; the Image2 Draw card and image-generation tools are removed.

Usage

1. Open Settings > Plugins > Configurable plugins > Image2 Draw.
2. Enter the API key supplied by your relay.
3. Enter the relay endpoint, for example https://example.com/v1.
4. Adjust the model, edit endpoint, or timeout if needed; the defaults normally work without changes.
5. Click Save and wait for the Saved status.
6. Start a new session and ask the model to call image2-generate, or provide reference image paths and use image2-edit.

Example prompts:

Call image2-generate to create a portrait cinematic poster of a future city at high quality.

Call image2-edit with D:\images\room.png and restyle the room with light Japanese wood while preserving the layout.

Support for gpt-image-2, image editing, custom dimensions, and quality levels depends on the relay implementation. If the API returns HTTP 400 or 404, check the provider's model name and Images endpoint documentation.

Image and request limits

• Text-to-image accepts a count from 1 to 8 and sends one upstream request at a time.
• Image editing accepts 1-8 reference images, up to 4MB each and 32MB total.
• Reference images must be PNG, JPEG, or WebP. Their format is detected from magic bytes rather than trusted filename extensions.
• Relative reference paths resolve from the current session working directory.
• The default timeout is 180 seconds and the configurable range is 1-3600 seconds.
• Generated results must be PNG, JPEG, or WebP. Remote image downloads are limited to 32MB.

Development

npm install
npm test

Compatibility

Built against the public dual-end plugin, settings namespace, credentials, tool registration, client slot, and WebServer lifecycle interfaces of DeepSeek Harness 0.1.0-rc.6. Harness is still in Developer Preview; if the plugin stops loading after an upgrade, check these interfaces and the dsh.client.inject declaration.

License

MIT