概览/OpenAPI/编辑与错误处理

编辑与错误处理

分镜编辑、Omni 多轮迭代与错误处理。

编辑与错误处理

接口:

POST /creations/{creation_id}/edit

视频分镜编辑

{  "action": "update_scene_narration",  "scene_id": "section_2",  "narration_text": "新的旁白"}

也可以使用 regenerate_scene 重做指定场景。调用前先读取详情中的 editable_actionsscenes[]

AI 视频多轮编辑

仅当详情或 Catalog 明确返回 iterate / supports_conversation_edit=true 时使用:

{  "action": "iterate",  "prompt": "保持镜头运动不变,把灯光改成暖色"}

调用时不需要 interaction ID。Veo 不支持 iterate,应重新创建。

参数错误返回 400/422;权限、会员和积分问题应根据结构化错误码处理,不要盲目重试。

先确认完成结果允许什么编辑

编辑基于实际能力。原任务成功后,读取 GET /creations/{creation_id},检查 editable_actionsscenes[],再展示编辑入口。客户端不应暗示所有结果、字段或 provider 都有同一条修订路径。只有详情明确开放时,才能进行分镜级操作。

每次编辑都按异步任务处理

编辑也会创建异步工作。保存编辑响应返回的任务信息,轮询任务接口,并且只在成功后刷新 creation 详情。交付刷新后的 main_url、产物、分镜和可编辑动作,不要继续展示旧版本的缓存结果。

不要用重复编辑掩盖错误

结合结构化 HTTP 响应和任务状态,区分参数错误、不支持的动作、权限以及会员或积分限制。修正请求,或请用户做必要决定后再提交下一次编辑。对于 Veo 或未开放所需动作的 creation,应使用有效参数创建新结果,不要反复调用 iterate

关联文档