跳至本文
使用文件

搜尋文件

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

正在載入搜尋索引…

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

傳輸影片位元組

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

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

操作

PUT /video-uploads/{upload_id}/content

operationId: transfer_video_upload_v1_video_uploads__upload_id__content_put

按返回的 PUT URL 和 X-AnimGen-Upload-Token 傳輸原影片位元組,不附加 API/OAuth 憑據。準確匹配 Content-Type 和 byte_size。即使沒有 Content-Length 也限制流式位元組數;使用檔案 ID 前需完成上傳。

鑑權與副作用

使用返回的完整簽名 URL,不攜帶 Bearer Key。

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

引數

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

請求體 (application/octet-stream)

請求體必填:true

沒有物件欄位,參見 Schema 型別與約束。

響應

HTTP 正文 含義
204 — 影片位元組已傳輸,接下來完成上傳會話。
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 建議等待秒數,遵循服務值並設定總體截止時間。

相關教程

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

這篇文件有幫助嗎?

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

需要協助?聯絡支援