保存文章新版本

将一次写作结果保存为新的版本快照，便于后续选择和恢复。

v1同步操作 Bearer 鉴权

POSThttps://popto.cn/api/open/v1/pipeline/wechat_article_follow_create/version/save

鉴权与请求头

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

AuthorizationBearer <POPTO_API_KEY>必填

Content-Typeapplication/json必填

请求参数 Body · JSON

flow_idstring必填

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

idempotency_keystring必填

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

source_idstring必填

版本所属工作流 ID，通常与 flow_id 一致。

project_idstring可选

项目 ID，可选。

snapshotobject必填

展开查看对象字段。

查看子字段 6

actionstring可选

来源动作，如 draft、rewrite、continue、humanize、title_suggest。

labelstring可选

版本标签。

titlestring可选

文章标题。

digeststring可选

文章摘要。

markdownstring必填

文章 Markdown，不能为空，最多 60000 个字符。

image_placeholdersobject[]可选

图片规划与占位信息。

查看数组元素字段 8

idstring可选

图片 ID。

kindstring可选

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

image_urlstring可选

生成图片的 CDN URL。

wx_image_urlstring可选

上传后的微信图片 URL。

placementstring可选

插入位置。

captionstring可选

配图说明。

promptstring可选

图片生成提示词。

aspect_ratiostring可选

图片比例。

返回值与结构

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

source_idstring

来源 ID。

gen_versioninteger

新版本号。

snapshotobject

展开查看对象字段。

查看子字段 6

actionstring

来源动作，如 draft、rewrite、continue、humanize、title_suggest。

labelstring

版本标签。

titlestring

文章标题。

digeststring

文章摘要。

markdownstring

文章 Markdown，不能为空，最多 60000 个字符。

image_placeholdersobject[]

图片规划与占位信息。

查看数组元素字段 8

idstring

图片 ID。

kindstring

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

image_urlstring

生成图片的 CDN URL。

wx_image_urlstring

上传后的微信图片 URL。

placementstring

插入位置。

captionstring

配图说明。

promptstring

图片生成提示词。

aspect_ratiostring

图片比例。

created_atinteger

创建时间，Unix 秒。

调用说明

source_id 必须是当前用户的跟创工作流。最多保留 50 个版本。
跟创动作的 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/version/save' \
  --header "Authorization: Bearer $POPTO_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "flow_id": "flow_example",
  "idempotency_key": "example-version-save-001",
  "source_id": "flow_example",
  "snapshot": {
    "action": "draft",
    "label": "初稿",
    "title": "文章标题",
    "markdown": "## 标题\n文章正文……"
  }
}'

成功响应200 OK

json

{
  "ret": 0,
  "msg": "success",
  "data": {
    "ent": {
      "source_id": "flow_example",
      "gen_version": 1,
      "snapshot": {
        "action": "draft",
        "title": "文章标题",
        "markdown": "## 标题\n文章正文……"
      },
      "created_at": 1793700000
    }
  }
}

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