跳至本文
使用文件

搜尋文件

搜尋僅在此瀏覽器進行,關鍵字不會傳送或儲存。請勿輸入憑證。

正在載入搜尋索引…

Tab 或方向鍵移動 · Enter 開啟 · Esc 關閉
瀏覽文件

完成影片上傳

從原始碼生成 POST /video-uploads/{upload_id}/complete 的鑑權、欄位、響應、錯誤與安全呼叫參考。

公開測試API v1 · 1.5.0最後核實
本頁目錄

操作

POST /video-uploads/{upload_id}/complete

operationId: finish_video_upload_v1_video_uploads__upload_id__complete_post

校驗上傳來源元資訊並返回可複用影片 file_id,重複完成返回同一檔案。不啟動深度處理;生成時在 input.reference_video 指定合法選區。原影片上限 30 秒,選區 2–5 秒,受模型更低上限約束。

鑑權與副作用

使用可信環境中的 Bearer API Key。所需權限:animations:write

此操作不啟動付費生成,其他狀態變化見上文說明。

引數

引數 位置 型別 必填 約束 / 預設值 含義
upload_id path string 是 format: uuid 所屬公共資源 UUID;任務、資產、檔案 ID 不能互換。

響應

HTTP 正文 含義
200 VideoFileResponse 成功的公開響應,示例數值僅用於說明。
400 APIErrorEnvelope 輸入錯誤,修正請求後再嘗試。
401 APIErrorEnvelope API Key 缺失、到期或被撤銷。
403 APIErrorEnvelope 帳戶資格、帳戶狀態或 Key 權限不允許此操作。
404 APIErrorEnvelope 資源不可用、不屬於當前使用者,或簽名無效/過期。
409 APIErrorEnvelope 冪等衝突;僅 IDEMPOTENCY_IN_PROGRESS 可複用原請求重試。
410 APIErrorEnvelope 上傳會話已到期,請重新建立。
413 APIErrorEnvelope 請求或解碼後的圖片超過配置限制。
415 APIErrorEnvelope 使用支援的圖片媒體型別。
422 APIErrorEnvelope 影片元資訊或位元組數不合法。
429 APIErrorEnvelope 觸發帳戶級速率或佇列限制,遵循 Retry-After 等待。
500 APIErrorEnvelope 內部錯誤,保留任務 ID 和冪等鍵,僅標記可重試時重試。
503 APIErrorEnvelope 服務或供應商不可用,僅 error.retryable 為 true 時重試。

響應頭

HTTP 響應頭 型別 含義
429 Retry-After integer 建議等待秒數,遵循服務值並設定總體截止時間。
503 Retry-After integer 建議等待秒數,遵循服務值並設定總體截止時間。

響應示例

json
{
  "byte_size": 1024,
  "duration_seconds": 5,
  "file_id": "00000000-0000-4000-8000-000000000001",
  "height": 768,
  "mime_type": "video/mp4",
  "object": "file",
  "sha256": "0000000000000000000000000000000000000000000000000000000000000000",
  "width": 768
}

相關教程

輪詢與下載 · 錯誤與安全重試

這篇文件有幫助嗎?

不收集搜尋字詞、程式碼或自由文字。此開關僅控制文件互動事件。 隱私權政策

需要協助?聯絡支援