你將建置的內容
你將提交一個 Kling 文生影片任務、儲存回傳的任務 ID、輪詢對應的 Kling 任務端點,並決定何時加入callback_url 以接收推播通知。
先決條件
- 儲存在
COMETAPI_KEY中的 CometAPI API key - 安裝
requests的 Python 3.10+,或 Node.js 18+ - 用於輪詢的伺服器端 worker,或用於 webhook 的 HTTPS 回呼端點
API key、基礎 URL、驗證
使用以下端點建立 Kling 文生影片任務:程式碼範例
使用下方分頁取得可直接複製的 cURL、Python 與 Node.js 範例。流程說明
Kling 影片生成是非同步的。建立端點會回傳data.task_id。持續輪詢 GET /kling/v1/videos/text2video/<task_id>,直到 data.task_status 變成 succeed 或 failed。當任務成功時,如果你需要持久存取,請將 data.task_result 中已完成的資產 URL 複製到你自己的儲存空間。
當你希望將任務狀態更新推送到你所控制的 HTTPS 端點時,請加入 callback_url。同時保留輪詢機制,以便進行狀態校對與處理遺漏的 callback 傳送。
常見參數
疑難排解 / 常見問題
回應格式與 OpenAI 影片路由不同
回應格式與 OpenAI 影片路由不同
Kling 使用供應商特定的 JSON 欄位,例如
data.task_id、data.task_status 和 data.task_result。不要像解析 OpenAI 相容的 /v1/videos 路由那樣解析它。任務始終沒有進入 succeed
任務始終沒有進入 succeed
請使用有界輪詢,並在任務失敗時檢查
data.task_status_msg。請儲存 task ID 以便後續診斷。我應該使用 callback_url 還是輪詢
我應該使用 callback_url 還是輪詢
以輪詢作為基準做法。加入
callback_url 以進行推送傳送,然後再透過輪詢校對最終狀態。後續步驟
- 閱讀 Kling 文字轉影片 API 參考。
- 使用 取得 Kling 任務 進行輪詢。
- 使用 設定 Kling callback URL 來配置 callback。
- 在 Models 中尋找 Kling 影片模型。
- 參閱 在影片生成中使用輪詢與 webhook。
- 使用 在呼叫模型前估算請求成本 來預估任務成本。