選擇影片 API
建立 Seedance 影片
建立 Seedance 影片任務。
建立 HappyHorse 影片
建立 HappyHorse 文字轉影片任務。
建立 Sora 2 影片
建立 Sora 2 影片任務。
擷取 Sora 2 影片
查詢 Sora 影片任務。
建立 Veo 3 影片
建立 Veo 影片任務。
建立 Wan 影片
建立 Wan 文字轉影片任務。
建立 xAI 影片
產生 xAI 影片任務。
建立 Vidu 影片
建立 Vidu 文字轉影片任務。
建立 Omni 影片(Beta)
建立測試版 Omni 影片任務。
建立 Kling 文字轉影片任務
從文字 Prompt 產生 Kling 影片。
建立 Runway 圖片轉影片任務
從圖片產生 Runway 影片。
建立並輪詢影片任務
使用來自Models 頁面或模型目錄的支援影片 model ID。以下範例會先透過POST /v1/videos 建立影片任務,然後輪詢回傳的 task ID,直到任務進入終止狀態。
回應範例
成功的建立回應可能如下所示。在開始輪詢之前,請先儲存 task ID:video_url;某些供應商格式會使用 model 專屬的結果欄位,或在該路由有文件說明時使用影片內容路由:
範例 model 記錄
此範例模型目錄回應展示了
/api/models 的封裝格式,以及一筆影片模型記錄的結構。這不是完整的模型清單。cURL
常見錯誤
Missing task ID
Missing task ID
在你的作業處理常式返回之前,先儲存建立回應中的 ID。
Polling too fast
Polling too fast
在狀態檢查之間加入延遲與退避機制。
Unsupported duration or size
Unsupported duration or size
請使用所選影片端點文件中記載的 duration 與 resolution 欄位。
Missing video_url
Missing video_url
將
video_url 視為可選欄位,並在可用時回退至模型特定的結果欄位或 content 路由。Callback not received
Callback not received
以輪詢作為事實來源,並確認你的 callback URL 可接受 POST 請求。
錯誤碼與重試策略
400
400
在修正 prompt、檔案、duration 或 size 欄位之前,請勿重試。
401
401
在 API key 存在且有效之前,請勿重試。
404
404
重試前請檢查 task ID、base URL、path 和 model ID。
413
413
重試前請先縮減上傳大小。
429
429
使用指數退避重試,並降低建立請求或輪詢的並行數。
500 or 503
500 or 503
以退避機制重試任務建立;除非任務進入最終錯誤狀態,否則請持續輪詢既有任務。
定價與模型目錄
Models page
了解 CometAPI 如何在文件中公開 model ID。
Model directory
瀏覽可用模型及其功能。
Pricing
在呼叫模型之前先查看定價。