概覽/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。