编辑与错误处理
接口:
POST /creations/{creation_id}/edit
视频分镜编辑
{ "action": "update_scene_narration", "scene_id": "section_2", "narration_text": "新的旁白"}
也可以使用 regenerate_scene 重做指定场景。调用前先读取详情中的 editable_actions 和 scenes[]。
AI 视频多轮编辑
仅当详情或 Catalog 明确返回 iterate / supports_conversation_edit=true 时使用:
{ "action": "iterate", "prompt": "保持镜头运动不变,把灯光改成暖色"}
调用时不需要 interaction ID。Veo 不支持 iterate,应重新创建。
参数错误返回 400/422;权限、会员和积分问题应根据结构化错误码处理,不要盲目重试。
先确认完成结果允许什么编辑
编辑基于实际能力。原任务成功后,读取 GET /creations/{creation_id},检查 editable_actions 与 scenes[],再展示编辑入口。客户端不应暗示所有结果、字段或 provider 都有同一条修订路径。只有详情明确开放时,才能进行分镜级操作。
每次编辑都按异步任务处理
编辑也会创建异步工作。保存编辑响应返回的任务信息,轮询任务接口,并且只在成功后刷新 creation 详情。交付刷新后的 main_url、产物、分镜和可编辑动作,不要继续展示旧版本的缓存结果。
不要用重复编辑掩盖错误
结合结构化 HTTP 响应和任务状态,区分参数错误、不支持的动作、权限以及会员或积分限制。修正请求,或请用户做必要决定后再提交下一次编辑。对于 Veo 或未开放所需动作的 creation,应使用有效参数创建新结果,不要反复调用 iterate。
