编辑已有内容
解说视频支持用自然语言继续修改:
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。
