上传配图到公众号

将本工作流已生成的图片上传到选定公众号，保存可恢复的素材回执。

v1同步操作 Bearer 鉴权

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

鉴权与请求头

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

AuthorizationBearer <POPTO_API_KEY>必填

Content-Typeapplication/json必填

请求参数 Body · JSON

flow_idstring必填

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

idempotency_keystring必填

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

image_idstring必填

本工作流生成结果中的图片 ID。

account_idstring必填

当前用户拥有的公众号 ID。

image_urlstring必填

与 image_id 匹配的生成图片 HTTP(S) URL。

kindstring必填

上传用途，推荐使用 cover / content。

可选值 covercontentbody

filenamestring可选

可选文件名。

content_typestring可选

可选图片 MIME 类型。

返回值与结构

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

flow_idstring

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

image_idstring

图片 ID。

account_idstring

公众号 ID。

kindstring

cover / content。

media_idstring

封面的永久素材 ID。

urlstring

微信图片 URL。

image_urlstring

原生成图片 URL。

调用说明

cover 返回永久素材 media_id；content 返回正文素材 URL。body 会被规范化为 content。每个账号需单独上传素材。
跟创动作的 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/image_apply' \
  --header "Authorization: Bearer $POPTO_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "flow_id": "flow_example",
  "idempotency_key": "example-image_apply-001",
  "image_id": "cover",
  "account_id": "account_example",
  "image_url": "https://cdn.example.com/cover.png",
  "kind": "cover"
}'

成功响应200 OK

json

{
  "ret": 0,
  "msg": "success",
  "data": {
    "ent": {
      "flow_id": "flow_example",
      "image_id": "cover",
      "account_id": "account_example",
      "kind": "cover",
      "media_id": "media_example",
      "url": "https://mmbiz.qpic.cn/example",
      "image_url": "https://cdn.example.com/cover.png"
    }
  }
}

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