錯誤

VIDIO API 使用一致的錯誤物件格式。使用此頁面來了解常見的錯誤類型、HTTP 狀態碼和 API 返回的範例訊息。

目前僅提供企業計劃的 API 存取權限。如果您不是企業用戶但有興趣使用 API，請在這裡申請存取權限。

概述

當請求失敗時，VIDIO API 會返回一個 error 物件，包含 type 和 message。一些錯誤可能還會包括額外的欄位來幫助解釋失敗原因。

錯誤格式

json

{
  "error": {
    "type": "invalid_request_error",
    "message": "未找到工作"
  }
}

錯誤參考

Status	Type	Message	Description
400	invalid_request_error	上傳 URL 請求中缺少必要的查詢參數	當上傳 URL 請求中缺少必要的查詢參數時返回。
400	invalid_request_error	缺少 job_id	當渲染請求未包含工作 ID 時返回。
400	invalid_request_error	此工作沒有可用的輸出	當工作沒有任何可渲染的輸出時返回。
400	invalid_request_error	input_keys 必須是一個非空陣列	當 `input_keys` 缺失或為空時返回。
400	invalid_request_error	input_keys 必須包含至少一個有效的輸入鍵	當所有提供的輸入鍵在標準化後都為空白或無效時返回。
400	invalid_request_error	無效的 video_category。允許的值：podcast、球類運動、非球類運動、美妝產品示範、婚禮、旅遊、其他	當 `video_category` 不被支持時返回。
400	invalid_request_error	無效的 aspect_ratio。允許的值：方形、直式、橫式	當 `aspect_ratio` 不被支持時返回。
400	invalid_request_error	output_length 必須是一個正數	當 `output_length` 缺失、為零或為負時返回。
400	invalid_request_error	無法從 input_keys 元資料中確定正確的輸入時長	當 API 無法確定上傳輸入的有效時長時返回。
401	authentication_error	缺少 API 金鑰	當未提供 `x-api-key` 標頭時返回。
401	authentication_error	無效的 API 金鑰	當提供的 API 金鑰與有效金鑰不匹配時返回。
402	insufficient_balance	您沒有足夠的信用來處理此工作	當帳戶沒有足夠的信用來處理或渲染時返回。
403	permission_error	您沒有權限訪問此工作	當經認證的用戶不擁有請求的工作時返回。
403	permission_error	您沒有權限渲染此工作	當經認證的用戶不擁有正在渲染的工作時返回。
404	invalid_request_error	未找到工作	當請求的工作不存在時返回。
404	invalid_request_error	未找到用戶	當找不到經認證用戶的記錄時返回。
429	rate_limit_error	請求過多	當客戶端超過端點的允許請求速率時返回。當前限制為每分鐘 60 次請求。速率限制主要適用於通過 x-api-key 標頭的 API 金鑰，當未提供 API 金鑰時，則退回到客戶端 IP 位址。超出此限制的客戶端應降低請求頻率，並在速率限制窗口重置後重試。
500	api_error	身份驗證錯誤	當 API 金鑰身份驗證在服務器上意外失敗時返回。
500	api_error	內部伺服器錯誤	當狀態、渲染或高亮片段端點出現意外的服務器端故障時返回。
500	server_error	無法生成上傳 URL	當服務器無法生成簽名的上傳 URL 時返回。