傳輸影片位元組
從原始碼生成 PUT /video-uploads/{upload_id}/content 的鑑權、欄位、響應、錯誤與安全呼叫參考。
本頁目錄
操作
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 |
建議等待秒數,遵循服務值並設定總體截止時間。 |
相關教程
這篇文件有幫助嗎?
不收集搜尋字詞、程式碼或自由文字。此開關僅控制文件互動事件。 隱私權政策