创作与修改初稿
支持初稿、改写、续写、去 AI 味及标题建议,结果通过任务查询获取。
v1异步任务 Bearer 鉴权
POST
https://popto.cn/api/open/v1/pipeline/wechat_article_follow_create/article_draft鉴权与请求头
在 API 密钥管理 ↗ 创建密钥,每次请求在 HTTP Header 中携带。
AuthorizationBearer <POPTO_API_KEY>必填Content-Typeapplication/json必填请求参数 Body · JSON
当前用户的工作流 ID,由 analysis_article 返回。
本次操作的唯一幂等键,8–128 个字符。同一请求重试保持原键与原请求体;修改内容后使用新键。
本次异步操作允许消耗的积分上限。先用 quote 获取报价,再明确填写预算。
写作动作,默认 draft。
可选值
draftrewritecontinuehumanizetitle_suggest选题;draft 时 topic 或 topic_card 至少填一项。
article_topics 返回的候选选题。
查看子字段 10
选题 ID。
选题名称。
选题类型。
切入角度。
读者痛点。
候选标题。
大纲。
摘要候选。
预计字数。
所需材料。
已有正文;rewrite、continue、humanize 时必填。
补充创作或修改要求。
创作配置;未填写的选项按服务默认值补齐。可从 capabilities.default_config 获取。
查看子字段 18
文章类别。
目标读者。
语气,默认:轻松专业。
选题方向。
标题风格,默认:干货型。
标题建议长度,默认 64。
写作风格,默认:口语化。
段落偏好,默认:短段为主。
小标题密度。
目标字数,默认字符串 2500。
文章署名,可为空,最多 8 个字符。
标题禁用短语。
正文禁用词。
配图风格。
配图密度。
封面比例,默认 2.35:1。
正文图片比例,默认 16:9。
账号定位、业务资料与品牌背景。
参考资料列表。
查看数组元素字段 3
材料名称。
来源链接。
参考内容。
返回值与结构
成功时 ret = 0,业务数据位于 data.ent。以下为 data.ent 中的字段。
当前用户的工作流 ID,由 analysis_article 返回。
异步任务 ID;使用 task/batch_get 查询执行结果。
调用说明
- title_suggest 需要 markdown 或 topic。异步写作完成后可调用 version/save 保存版本快照。
- 跟创动作的 JSON 请求体最大 1 MiB;较大的参考文档请使用专用上传接口。
- 同一工作流的写操作串行执行。结果未知时保留原 idempotency_key,通过 workflow/info 查看记录,并以原请求恢复。
- 跟创 API 需要服务端启用相应能力。article_publish 只同步微信草稿箱,正式群发需在公众号后台完成。
处理业务响应