md2wechat Agent API markAgent API 文档
md2wechat Agent API markAgent API 文档
首页

开始

Markdown 转微信公众号 API 文档QuickstartAuth

接口

API OverviewThemeConvert发布 API微信 IP 白名单多账号发布图片生成标题生成封面图Advanced LayoutMode SelectionAdvanced Layout Use CasesAdvanced Layout SyntaxAdvanced Layout MistakesDiscovery-First Workflowdoctor 与 inspect 准备状态Advanced Layout Recipes排版模块目录

接入

运维

ErrorsPricingContact
X (Twitter)
API

图片生成

文章配图与封面的命令、供应商、预设与免 Key 的 plan 模式。

图片生成

命令

  • md2wechat generate_image [prompt]——按提示词生成一张图
  • md2wechat generate_cover——用封面预设生成封面(默认 cover-default,16:9)
  • md2wechat generate_infographic——生成信息图(默认 infographic-default,3:4)

供应商

供应商默认模型备注
minimaximage-01唯一支持 --subject-reference(仅公网 http(s) URL、仅 image-01)
openaigpt-image-2另有 1.5 / 1 / 1-mini / dall-e-3 / 2
tuzidoubao-seedream-4-5-251128需 IMAGE_API_BASE
modelscope / msTongyi-MAI/Z-Image-Turbo
openrouter / orGemini 3 Pro image另有 Flux.2、Riverflow
gemini / google官方 SDK 模型忽略 image_api_base
volcengine / volcdoubao-seedream-5-0-pro-260628支持 2K/3K

发现供应商:md2wechat providers list、md2wechat providers show <name>。

预设

封面预设(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)。

信息图预设(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 cover

Plan 模式(免 Key、免上传)

md2wechat generate_cover --preset cover-default --article article.md --plan --json

返回 IMAGE_PLAN_READY,包含渲染好的 prompt、aspect、suggested_filename 与 alt_text。Plan 模式不需要供应商、不需要 IMAGE_API_KEY、不上传——由宿主 Agent 自己的图像工具执行。

直接生成是微信副作用

直接生成的链路是 生成 → 下载 → 上传微信素材,因此需要微信凭证加 IMAGE_API_KEY。在 --upload/--draft 期间,内联占位符会就地生成并替换:

![暖色主视觉插画](__generate:A warm hero illustration in flat style__)

相关页面

  • 封面图
  • 发布 API

多账号发布

用命名凭证与显式选择安全地管理多个公众号。

标题生成

title suggest 的 handoff 机制、hook 分级与终稿落位。

目录

图片生成
命令
供应商
预设
Plan 模式(免 Key、免上传)
直接生成是微信副作用
相关页面