Skip to main content
依照符合您任務類型的供應商工作流程,使用 CometAPI 影片模型文件。大多數影片端點都會建立非同步任務,因此請儲存任務 ID,並使用輪詢來擷取結果。只有在模型專屬頁面有記錄支援 callback 時,才加入 callback。

選擇影片 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,直到任務進入終止狀態。
這些範例使用佔位符 your-video-model-id。在執行請求之前,請將其替換為來自 Models 頁面模型目錄的可用影片 model ID。
開啟 建立 Seedance 影片取得 Seedance 影片,即可使用 API playground 與端點 schema。

回應範例

成功的建立回應可能如下所示。在開始輪詢之前,請先儲存 task ID:
成功的輪詢回應可能如下所示。已完成的回應可以包含 video_url;某些供應商格式會使用 model 專屬的結果欄位,或在該路由有文件說明時使用影片內容路由:

範例 model 記錄

此範例模型目錄回應展示了 /api/models 的封裝格式,以及一筆影片模型記錄的結構。這不是完整的模型清單。
cURL

常見錯誤

在你的作業處理常式返回之前,先儲存建立回應中的 ID。
在狀態檢查之間加入延遲與退避機制。
請使用所選影片端點文件中記載的 duration 與 resolution 欄位。
video_url 視為可選欄位,並在可用時回退至模型特定的結果欄位或 content 路由。
以輪詢作為事實來源,並確認你的 callback URL 可接受 POST 請求。

錯誤碼與重試策略

在修正 prompt、檔案、duration 或 size 欄位之前,請勿重試。
在 API key 存在且有效之前,請勿重試。
重試前請檢查 task ID、base URL、path 和 model ID。
重試前請先縮減上傳大小。
使用指數退避重試,並降低建立請求或輪詢的並行數。
以退避機制重試任務建立;除非任務進入最終錯誤狀態,否則請持續輪詢既有任務。

定價與模型目錄

Models page

了解 CometAPI 如何在文件中公開 model ID。

Model directory

瀏覽可用模型及其功能。

Pricing

在呼叫模型之前先查看定價。
最後修改於 2026年6月25日