dsh-minimax-image
English | 中文
A text-to-image plugin for DeepSeek Harness (DSH): turns a one-sentence visual description into a real image via the MiniMax image_generation API, saves it to your workspace, and exposes it to the model as an image-gen tool.
Features
- 🎨 Text-to-image: powered by the MiniMax
image-01 model, with 8 aspect ratios (16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 3:2 / 2:3 / 21:9)
- 🧩 DSH tool integration: registers the
image-gen tool so the model can generate images directly from the conversation
- 🔑 Credential reuse: reads
MINIMAX_API_KEY automatically (from the environment or the DSH credential store ~/.dsh/.credentials.yaml) — no extra setup
- 💾 Saved to disk: generated PNGs land in the workspace
generated/ directory (customizable via the output_dir argument)
Installation
Local install:
dsh plugin --profile web add /path/to/dsh-minimax-image
dsh plugin --profile headless add /path/to/dsh-minimax-image
Usage
After restarting dsh web, just describe the picture in the conversation, for example:
Generate a cyberpunk city night scene with neon lights and rain
The model calls the image-gen tool and returns the saved file path:
Generated 1 image (16:9):
- D:\AI_video\generated\minimax-2026-08-18T12-16-11-1.png
Configuration
Config precedence (highest wins):
- profile patch / plugin row config
~/.config/dsh-minimax-image/config.json
MINIMAX_IMAGE_* environment variables
- built-in defaults
Common options
| Field |
Description |
Default |
apiKeyEnv |
Environment variable holding the API key |
MINIMAX_API_KEY |
baseUrl |
MiniMax image generation endpoint |
https://api.minimaxi.com/v1/image_generation |
model |
Model ID |
image-01 |
aspectRatio |
Default aspect ratio |
16:9 |
outputDir |
Default output directory (relative to the workspace) |
generated |
timeoutMs |
Request timeout (milliseconds) |
120000 |
Example ~/.config/dsh-minimax-image/config.json:
{
"model": "image-01",
"aspectRatio": "9:16",
"outputDir": "generated",
"apiKeyEnv": "MINIMAX_API_KEY"
}
Environment variables
| Variable |
Meaning |
MINIMAX_API_KEY |
MiniMax API key (the DSH credential store is also supported) |
MINIMAX_IMAGE_MODEL |
Model ID |
MINIMAX_IMAGE_BASE_URL |
API endpoint |
MINIMAX_IMAGE_OUTPUT_DIR |
Output directory |
MINIMAX_IMAGE_TIMEOUT_MS |
Request timeout |
License
MIT