把爆款创作能力，
接入你的产品。

几分钟，完成第一次调用

所有公开接口均使用 POST。正式环境的服务地址为：

1. 01

   创建你的 API Key

   注册并登录 Popto，在 API 密钥管理 ↗ 中创建密钥。将其设置为服务端环境变量 POPTO_API_KEY。

   API Key 用于身份校验与积分计费。请保存在你的服务端，避免放进公开网页、代码仓库或分享链接。
2. 02

   提交分析任务

   选择一个可访问的视频链接，调用 爆款视频结构拆解。成功后保存 data.ent.task_id。

   bash复制代码

   curl --request POST \
     'https://popto.cn/api/open/v1/toolbox/hot_structure_dismantle' \
     --header "Authorization: Bearer $POPTO_API_KEY" \
     --header 'Content-Type: application/json' \
     --data '{
     "url": "https://v.douyin.com/VIDEO_SHARE_CODE/",
     "split_video": false
   }'

3. 03

   查询任务，取得结果

   将 task_id 传给 批量查询任务。当 status=success 时读取 outputs；失败时检查 error_msg。

   bash复制代码

   curl --request POST \
     'https://popto.cn/api/open/v1/task/batch_get' \
     --header "Authorization: Bearer $POPTO_API_KEY" \
     --header 'Content-Type: application/json' \
     --data '{
     "task_ids": [
       "task_example"
     ]
   }'

   pendingrunningsuccess

   建议每 3–5 秒轮询一次，并设置总超时。failed、cancelled 为终止状态。

从口播文案到数字人音视频

先查询数字人与外观， 再按需获取字幕预设、字体与计费配置。 每个数字人可配置独立脚本、外观和字幕。

只要音频时调用音频接口；只要视频时可直接提交视频渲染。 两者都需要时，保存首次返回的 tool_id 并用于后续请求。 使用批量查询任务获取outputs.items[].audio_url 或 output_video_url。

公众号文章，串成完整工作流

先查询能力与积分报价，再完成分析、偏好、选题、写作和配图。每个异步步骤完成后，继续下一步。

统一响应约定

业务数据从 data.ent 读取；成功标志为 ret=0。业务错误通常也返回 HTTP 200，应检查 JSON 响应。

{
  "ret": 0,
  "msg": "success",
  "data": {
    "ent": {
      "tool_id": "tool_example",
      "task_id": "task_example"
    }
  }
}