Skip to main content

你將建置的內容

你將提交一個 Kling 文生影片任務、儲存回傳的任務 ID、輪詢對應的 Kling 任務端點,並決定何時加入 callback_url 以接收推播通知。

先決條件

  • 儲存在 COMETAPI_KEY 中的 CometAPI API key
  • 安裝 requests 的 Python 3.10+,或 Node.js 18+
  • 用於輪詢的伺服器端 worker,或用於 webhook 的 HTTPS 回呼端點

API key、基礎 URL、驗證

使用以下端點建立 Kling 文生影片任務:
使用以下端點輪詢任務:
使用 Bearer token 進行驗證:

程式碼範例

使用下方分頁取得可直接複製的 cURL、Python 與 Node.js 範例。

流程說明

Kling 影片生成是非同步的。建立端點會回傳 data.task_id。持續輪詢 GET /kling/v1/videos/text2video/<task_id>,直到 data.task_status 變成 succeedfailed。當任務成功時,如果你需要持久存取,請將 data.task_result 中已完成的資產 URL 複製到你自己的儲存空間。 當你希望將任務狀態更新推送到你所控制的 HTTPS 端點時,請加入 callback_url。同時保留輪詢機制,以便進行狀態校對與處理遺漏的 callback 傳送。

常見參數

疑難排解 / 常見問題

Kling 使用供應商特定的 JSON 欄位,例如 data.task_iddata.task_statusdata.task_result。不要像解析 OpenAI 相容的 /v1/videos 路由那樣解析它。
請使用有界輪詢,並在任務失敗時檢查 data.task_status_msg。請儲存 task ID 以便後續診斷。
以輪詢作為基準做法。加入 callback_url 以進行推送傳送,然後再透過輪詢校對最終狀態。

後續步驟