動画の照会
ネイティブ形式の Kling 4.0 テキスト・画像・Omni タスクの状態と結果を照会します。
作成レスポンスの data.id で照会し、成功後は outputs から動画 URL を取得して保存します。現在のユーザーがアクセスできるタスクだけが返ります。
/kling/tasks/{task_id}現在のユーザーの単一 Kling 4.0 タスクを照会します。テキスト・画像・Omni 生成に対応します。options.external_task_id ではなくシステムのタスク ID を使用します。状態は submitted、processing、succeeded、failed です。ポーリング停止はキャンセルではありません。billing はタスクの定価と通貨のみを公開し、アカウント請求や内部課金明細は含みません。
billing.list_price は表示通貨の定価であり、プラットフォームの最終請求額ではありません。価格が動画結果より遅れて返る場合があり、未返却でも無料とは限りません。
状態と結果の保存
照会レスポンスの data はタスク配列です。単一 ID の照会でも配列として読み取ります。リクエストの code と生成タスクの status は別の意味です。結果の使用前にタスク状態を確認してください。
status | 意味 |
|---|---|
submitted | 送信済み、処理待ち |
processing | 処理中。後で再照会 |
succeeded | 生成成功。outputs から動画結果を取得 |
failed | 生成失敗。タスクの message を確認し、ポーリングを停止 |
動画結果の type は video、id は動画 ID、duration は文字列で返る秒数です。url は直リンク保護付き動画 URL です。透かし付き結果は実際に返る watermark_url を確認してください。
上流の生成結果は 30 日後に削除されます。速やかに保存してください。この保存期間は、直リンク保護付き URL が 30 日間有効である保証ではありません。
照会エラーと生成失敗
| 状況 | 確認と対処 |
|---|---|
HTTP 400、task_not_exist | 作成で返されたシステムタスク ID を使用し、API Key とサイトを確認。options.external_task_id は使用しない |
HTTP 401、Invalid token | Bearer 形式と Key の有効性を確認。未指定・無効な Key は同じエラーの場合あり |
HTTP 200、タスク status: "failed" | 照会は成功、生成は失敗。タスクの message を読み、ポーリングを停止 |
HTTP エラーの形式は成功時の data[] と異なる場合があります。HTTP 400/401 をタスクの failed と解釈せず、認証エラーや存在しないタスクではポーリングを停止してください。