dsh-minimax-image
Manifest validdeepseek harness minimax image generate plugin
dsh-minimax-image
MiniMax H3 Image generation for DeepSeek Harness (DSH): a generate_image tool, a live default-model setting, and per-session model overrides.
English | 中文
What it adds
| Surface | Where | What it does |
|---|---|---|
generate_image tool | any DSH agent | Text-to-image with MiniMax-H3-Image, downloads the results into minimax-images/ in the session working directory |
| Plugin page | Plugins → MiniMax 生图 / MiniMax image generation | Saves the API key, chooses the default model, switches the API site |
image_model tool and /image-model command | a conversation | Overrides the image model for that session only |
The model is chosen at two levels, highest priority first:
- Session override —
/image-model MiniMax-H3-Image-Highspeed, or ask the agent to callimage_model. Cleared with/image-model default. - Plugin default — the Default model field on the plugin page. It is a volatile configuration field, so a change applies to the next generation without restarting DSH.
Install
Requires DeepSeek Harness 0.2.2-rc.5 or newer. The package is @comfanworld/dsh-minimax-image; the GitHub repository is comfanworld/dsh-minimax-image.
In the app: Plugins → Add plugin → paste https://github.com/comfanworld/dsh-minimax-image → Install → Enable now.
From a terminal:
dsh plugin --profile <profile> add github:comfanworld/dsh-minimax-image
Then select the bundle in Plugins if it is not switched on yet.
From a local checkout (useful while developing): in Add plugin choose the local directory, or run dsh plugin --profile <profile> add /absolute/path/to/dsh-minimax-image. A linked checkout resolves its own dependencies, so run npm install (or pnpm install) in it first.
Configuration
Open Plugins, select MiniMax image generation, and fill in:
| Field | Meaning |
|---|---|
| API key | Stored in the local DSH credential store as MINIMAX_API_KEY, never in plugin configuration and never shown again. An MINIMAX_API_KEY environment variable also works; a stored key outranks it. |
| Default model | MiniMax-H3-Image (standard), MiniMax-H3-Image-Highspeed (high-speed), or a custom model id for a relay endpoint. Applies live. |
| API site | Optional override of the endpoint. The default is the mainland China site https://api.minimax.cn; use https://api.minimax.io for the international site, or a relay address. |
Get a key from the MiniMax platform → account management → API keys (platform.minimax.cn or platform.minimax.io; keys are not interchangeable between the two sites).
Usage
Just ask the agent for a picture:
画一只戴着圆框眼镜的柴犬在深夜写代码,赛博朋克风格,16:9
The agent calls generate_image; the images land in minimax-images/ under the session working directory and the reply shows them as Markdown images.
Tool parameters:
| Parameter | Meaning |
|---|---|
prompt | Image description, required |
count | 1–10 images, default 1; each successful image is billed |
size | Exact WIDTHxHEIGHT; omit to use aspect_ratio + area |
aspect_ratio | e.g. 16:9, 3:4, 1:1, or auto |
area | 1K, 2K (default), or 4K |
output_format | png, jpeg (default), or webp |
Limits
- Text-to-image only; the reference-image editing endpoint (
/v1/images/edits) is not exposed. - One request can take minutes; the tool waits up to 660 seconds. The endpoint is not idempotent, so a timeout may still be billed.
- Images are downloaded to disk; the service's own image URLs are not reused.
Development
npm install
DSH_PACKAGES=/path/to/dsh/node_modules/@deepseek-ai node test/host.test.mjs
node test/client.test.mjs
test/host.test.mjs exercises the tools, argument validation, model precedence, the session store, and request/response handling against a stubbed fetch. test/client.test.mjs drives the settings page through a minimal React stand-in and a fake Cordis context.
License
MIT. Not affiliated with MiniMax.
中文说明
把 MiniMax H3 Image 接进 DeepSeek Harness:一个 generate_image 工具、一个可实时修改的默认模型设置,以及按会话覆盖模型的能力。
安装
需要 DSH 0.2.2-rc.5 或更新版本。插件 → Add plugin → 粘贴 https://github.com/comfanworld/dsh-minimax-image → Install → Enable now。
配置
打开 插件 里的 MiniMax 生图:
- API Key:存进本机 DSH 凭据库(
MINIMAX_API_KEY),不写进插件配置,也不会回显。 - 默认模型:标准版
MiniMax-H3-Image/ 高速版MiniMax-H3-Image-Highspeed/ 自定义中转模型 ID;改完立即生效。 - API 站点:默认国内站
https://api.minimax.cn,可填国际站https://api.minimax.io或中转地址。
两级模型
| 层级 | 怎么用 | 生效范围 |
|---|---|---|
| 会话级 | 对话里输入 /image-model MiniMax-H3-Image-Highspeed,或让我调用 image_model | 只影响当前会话 |
| 插件默认 | 插件页的「默认模型」 | 所有没覆盖的会话 |
/image-model 不带参数显示当前选择,/image-model default 清除会话覆盖。会话覆盖按 session id 存在 ~/.dsh/minimax-image/sessions.json。
直接说需求
画一张雨夜霓虹街角的赛博朋克咖啡店,2K,16:9
我会调用 generate_image,图片存到会话工作目录的 minimax-images/ 并贴在回复里。
已知限制
只做文生图(未暴露参考图编辑接口);单次请求最长等 660 秒,接口不幂等,超时也可能计费。
许可证
MIT。与 MiniMax 官方无隶属关系。
Comments
Loading…
Similar plugins
by Jack-sun-learner
DeepSeek Harness 文生图插件:基于 MiniMax image-01 生成图片,注册 image-gen 工具
★ 0
MIT
JavaScript
Aug 19, 2026
dsh plugin --profile web add dsh-minimax-imageby dong2007-png
DSH plugin: generate images via a New API relay (tools: generate_image, list_image_models)
★ 0
MIT
JavaScript
Oct 1, 2026
dsh plugin --profile web add dsh-imagegenby zhangzhimou78-code
dsh-plugin
★ 0
MIT
JavaScript
Aug 20, 2026
dsh plugin --profile web add deepseek-visual-pluginby zzdream67
Let text-only models read images in DeepSeek Harness
★ 0
MIT
JavaScript
Aug 20, 2026
dsh plugin --profile web add @zzdream67/dsh-vision-bridgeby senyayume
DSH plugin: inline each image block only in the request where it first appears, then swap it for the harness's own placeholder text
★ 0
MIT
JavaScript
Oct 9, 2026
dsh plugin --profile web add dsh-image-onceby miller-owo
The GPT Image image generator plugin for DeepSeek Harness.
★ 0
MIT
JavaScript
Oct 18, 2026
dsh plugin --profile web add dsh-image-gen-plugin