Agent API DocsImage Generation
Commands, providers, presets, and the key-free plan mode for article and cover images.
Image Generation
Commands
md2wechat generate_image [prompt]— generate one image from a promptmd2wechat generate_cover— generate a cover with a cover preset (defaultcover-default, 16:9)md2wechat generate_infographic— generate an infographic (defaultinfographic-default, 3:4)
Providers
| Provider | Default model | Notes |
|---|---|---|
minimax | image-01 | The only provider supporting --subject-reference (public http(s) URL only, image-01 only) |
openai | gpt-image-2 | Also 1.5 / 1 / 1-mini / dall-e-3 / 2 |
tuzi | doubao-seedream-4-5-251128 | Requires IMAGE_API_BASE |
modelscope / ms | Tongyi-MAI/Z-Image-Turbo | |
openrouter / or | Gemini 3 Pro image | Also Flux.2, Riverflow |
gemini / google | official SDK models | Ignores image_api_base |
volcengine / volc | doubao-seedream-5-0-pro-260628 | 2K/3K sizes |
Discover providers: md2wechat providers list and md2wechat providers show <name>.
Presets
Cover presets (12): cover-default (16:9), cover-claude-warm (21:9), cover-hero, cover-metaphor, cover-illustrated, cover-editorial, cover-editorial-collage, cover-minimal, cover-data-visual, cover-semantic-concept (21:9), cover-suspense-black-gold (2.35:1).
Infographic presets (13): infographic-default, -claude-warm, -bento, -timeline, -dashboard, -hierarchy, -comparison, -process, -ticket-process, -apple-keynote-premium, -handdrawn-sketchnote, -flat-vector-panorama, -dark-ticket-cn, -victorian-engraving-banner.
md2wechat prompts list --kind image --archetype coverPlan mode (no key, no upload)
md2wechat generate_cover --preset cover-default --article article.md --plan --jsonReturns IMAGE_PLAN_READY with a rendered prompt, aspect, suggested_filename, and alt_text. Plan mode needs no provider, no IMAGE_API_KEY, and performs no upload — the host agent's own image tool executes the plan.
Direct generation is a side effect
Direct generation goes generate → download → upload to WeChat materials, so it requires WeChat credentials plus IMAGE_API_KEY. During --upload/--draft, inline placeholders generate and replace in place:
