同步到微信草稿箱

将最终审阅并排版的文章创建或更新至公众号草稿箱。此接口不会正式群发。

v1同步操作 Bearer 鉴权

POSThttps://popto.cn/api/open/v1/pipeline/wechat_article_follow_create/article_publish

鉴权与请求头

在 API 密钥管理 ↗ 创建密钥，每次请求在 HTTP Header 中携带。

AuthorizationBearer <POPTO_API_KEY>必填

Content-Typeapplication/json必填

请求参数 Body · JSON

flow_idstring必填

当前用户的工作流 ID，由 analysis_article 返回。

idempotency_keystring必填

本次操作的唯一幂等键，8–128 个字符。同一请求重试保持原键与原请求体；修改内容后使用新键。

account_idstring必填

目标公众号 ID，必须属于当前用户且已授权。

article_idstring可选

更新现有草稿时填写上次回执的 article_id。

revisioninteger可选

更新时填写上次回执的 revision，成功后递增。

articlesobject[]必填

当前必须恰好包含一篇文章。

查看数组元素字段 33

titlestring必填

已审阅的文章标题。

authorstring可选

署名，最多 8 个字符。

digeststring可选

已审阅摘要。

content_htmlstring必填

已排版 HTML，图片替换为当前账号微信 URL。

content_source_urlstring可选

阅读原文 URL，可选。

thumb_media_idstring必填

当前账号已上传封面的永久素材 ID。

thumb_asset_idstring可选

封面资产 ID，可选。

need_open_commentinteger可选

是否开启留言：1 开启，0 关闭。

可选值 01

only_fans_can_commentinteger可选

是否仅粉丝可留言：1 是，0 否。

可选值 01

show_cover_picinteger可选

是否显示封面。

source_markdownstring必填

与最终审阅一致的正文，图片按回执替换为微信 URL。

creative_configobject可选

创作配置；未填写的选项按服务默认值补齐。可从 capabilities.default_config 获取。

查看子字段 18

article_categorystring可选

文章类别。

target_readerstring可选

目标读者。

tonestring可选

语气，默认：轻松专业。

topic_directionstring可选

选题方向。

title_stylestring可选

标题风格，默认：干货型。

title_max_lengthinteger可选

标题建议长度，默认 64。

writing_stylestring可选

写作风格，默认：口语化。

paragraph_preferencestring可选

段落偏好，默认：短段为主。

heading_densitystring可选

小标题密度。

target_word_countstring可选

目标字数，默认字符串 2500。

default_authorstring可选

文章署名，可为空，最多 8 个字符。

forbidden_title_phrasesstring[]可选

标题禁用短语。

forbidden_wordsstring[]可选

正文禁用词。

image_stylestring可选

配图风格。

image_densitystring可选

配图密度。

cover_aspectstring可选

封面比例，默认 2.35:1。

article_image_aspectstring可选

正文图片比例，默认 16:9。

business_contextstring可选

账号定位、业务资料与品牌背景。

review_reportobject可选

article_review 返回的审稿报告；服务端仍会重新校验持久化报告。

image_planobject可选

图片规划结果。

generated_imagesobject[]可选

已生成及已上传的图片凭证。

查看数组元素字段 7

idstring可选

图片 ID。

kindstring可选

cover / content。

promptstring可选

生成提示词。

urlstring可选

生成图片 URL。

wechat_urlstring可选

微信图片 URL。

media_idstring可选

微信永久素材 ID。

account_idstring可选

素材所属公众号 ID。

format_themestring可选

排版主题。

format_font_sizestring可选

正文字号。

format_backgroundstring可选

背景配置。

topic_seedstring可选

选题方向。

topic_cardobject可选

article_topics 返回的候选选题。

查看子字段 10

idstring可选

选题 ID。

namestring可选

选题名称。

typestring可选

选题类型。

anglestring可选

切入角度。

reader_painstring可选

读者痛点。

titlesstring[]可选

候选标题。

outlinestring[]可选

大纲。

summary_optionsstring[]可选

摘要候选。

estimated_wordsinteger可选

预计字数。

material_needsstring可选

所需材料。

knowledge_notesstring可选

知识资料。

research_notesstring可选

研究资料。

preference_source_urlstring可选

参考文章 URL。

preference_titlestring可选

参考标题。

preference_authorstring可选

参考作者。

preference_contentstring可选

参考正文。

preference_analysis_summarystring可选

参考分析摘要。

preference_resultobject可选

偏好推导结果。

wechat_cover_urlstring可选

微信封面 URL。

wechat_image_urlsstring[]可选

微信正文图片 URL。

wechat_image_account_idstring可选

素材所属账号。

workflow_stagestring可选

工作流阶段。

content_modestring可选

内容模式。

返回值与结构

成功时 ret = 0，业务数据位于 data.ent。以下为 data.ent 中的字段。

flow_idstring

当前用户的工作流 ID，由 analysis_article 返回。

article_idstring

文章 ID，更新时复用。

draft_media_idstring

微信草稿素材 ID。

revisioninteger

当前修订号。

statusstring

草稿状态。

调用说明

示例结构用于说明字段；必须填入当前工作流真实的审稿、排版和素材产物后才能通过门禁。
必须先上传封面及所有规划图片，完成该账号的最终审阅并重新排版。存在 must 问题、素材未准备或内容已变更时会拒绝同步。
遇到 50111 结果未知时，保持原键恢复，避免重复创建微信草稿。
跟创动作的 JSON 请求体最大 1 MiB；较大的参考文档请使用专用上传接口。
同一工作流的写操作串行执行。结果未知时保留原 idempotency_key，通过 workflow/info 查看记录，并以原请求恢复。
跟创 API 需要服务端启用相应能力。article_publish 只同步微信草稿箱，正式群发需在公众号后台完成。

处理业务响应

HTTP 200 仍可能返回业务错误，请同时检查 ret、code 和 msg。查看响应与错误码

请求示例Request

bash

curl --request POST \
  'https://popto.cn/api/open/v1/pipeline/wechat_article_follow_create/article_publish' \
  --header "Authorization: Bearer $POPTO_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "flow_id": "flow_example",
  "idempotency_key": "example-article_publish-001",
  "account_id": "account_example",
  "articles": [
    {
      "title": "中小企业的 AI 内容工作流",
      "author": "",
      "digest": "从选题到成稿的实践方法。",
      "content_html": "<section>最终审阅后渲染的 HTML</section>",
      "thumb_media_id": "media_example",
      "source_markdown": "最终审阅通过的正文",
      "need_open_comment": 1,
      "only_fans_can_comment": 0,
      "creative_config": {},
      "generated_images": []
    }
  ]
}'

成功响应200 OK

json

{
  "ret": 0,
  "msg": "success",
  "data": {
    "ent": {
      "flow_id": "flow_example",
      "article_id": "article_example",
      "draft_media_id": "draft_example",
      "revision": 1,
      "status": "draft"
    }
  }
}

示例内容用于说明结构。任务 ID、积分和执行结果以实际响应为准。