編輯已有內容
解說視頻支持用自然語言繼續修改:
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。
