概览/OpenAPI/编辑与继续

编辑与继续

继续修改已有内容,或恢复最新暂停的任务。

编辑已有内容

解说视频支持用自然语言继续修改:

POST /creations/{id}/messages

示例:

{  "content": "保留其他部分,把第二个场景改得更适合新员工理解",  "input_file_ids": [],  "idempotency_key": "video-edit-20260901-001"}

你可以描述全局修改,也可以明确指定某个场景。服务端会规划影响范围,并在条件满足时继续生成。

AI 生图和 AI 应用当前不声明同一套对话式编辑能力。需要修改时,按 capabilities 返回的能力创建新的结果,不要假设 messages 对所有产品都可用。

继续暂停任务

当 GET /creations/{id} 返回 paused 时,先读取 available_actions。只有其中出现的操作才可以提交:

POST /creations/{id}/actions
{  "action": "resume_after_recharge",  "idempotency_key": "resume-20260901-001"}

可能出现的操作包括:

  • resume_after_recharge:积分已补足后继续。
  • approve_overage:确认新的积分估算后继续。
  • retry:仅在服务端明确允许安全重试时使用。

幂等与安全

  • 同一次消息或继续操作始终复用同一个 idempotency_key。
  • 不要为旧任务保存长期可点击的恢复按钮。
  • 只恢复最新暂停任务;服务端会再次校验。
  • available_actions 为空时,不要自行构造动作。
  • 远端状态不明时先查询状态,不要自动重提。
  • 只发送文档中列出的 creation ID、操作名称和幂等键。

状态变化

消息和继续操作同样是异步的。收到 202 后继续查询 GET /creations/{id}。进度应只前进不回退;完成后再刷新 outputs。