跳转到文档内容
接口文档 / 公众号跟创

审阅文章内容

审阅正文、图片与账号配置,生成审稿报告;微信草稿同步前须完成最终审阅。

v1异步任务 Bearer 鉴权
POSThttps://popto.cn/api/open/v1/pipeline/wechat_article_follow_create/article_review

鉴权与请求头

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

AuthorizationBearer <POPTO_API_KEY>必填
Content-Typeapplication/json必填

请求参数 Body · JSON

flow_idstring必填

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

idempotency_keystring必填

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

max_creditsinteger必填

本次异步操作允许消耗的积分上限。先用 quote 获取报价,再明确填写预算。

review_scopestring可选

审阅范围,默认 content。

可选值 contentwechat_release
titlestring可选

文章标题。

digeststring可选

文章摘要。

markdownstring必填

待审阅的正文,不能为空。

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可选

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

finalboolean可选

是否最终审阅;同步草稿前必须为 true。

selected_account_idstring可选

最终审阅选定的公众号 ID。

image_placeholdersobject[]可选

图片规划与占位信息。

查看数组元素字段 8
idstring可选

图片 ID。

kindstring可选

图片用途,cover 为封面,content 为正文。

image_urlstring可选

生成图片的 CDN URL。

wx_image_urlstring可选

上传后的微信图片 URL。

placementstring可选

插入位置。

captionstring可选

配图说明。

promptstring可选

图片生成提示词。

aspect_ratiostring可选

图片比例。

generated_imagesobject[]可选

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

查看数组元素字段 7
idstring可选

图片 ID。

kindstring可选

cover / content。

promptstring可选

生成提示词。

urlstring可选

生成图片 URL。

wechat_urlstring可选

微信图片 URL。

media_idstring可选

微信永久素材 ID。

account_idstring可选

素材所属公众号 ID。

返回值与结构

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

flow_idstring

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

task_idstring

异步任务 ID;使用 task/batch_get 查询执行结果。

调用说明

  • 同步微信草稿需 review_scope=wechat_release、final=true,且 selected_account_id 与目标账号一致。修改内容或素材后应重新审阅。
  • 跟创动作的 JSON 请求体最大 1 MiB;较大的参考文档请使用专用上传接口。
  • 同一工作流的写操作串行执行。结果未知时保留原 idempotency_key,通过 workflow/info 查看记录,并以原请求恢复。
  • 跟创 API 需要服务端启用相应能力。article_publish 只同步微信草稿箱,正式群发需在公众号后台完成。
处理业务响应
HTTP 200 仍可能返回业务错误,请同时检查 ret、code 和 msg。查看响应与错误码