動画の照会
プラットフォーム形式で送信した Kling 4.0 タスクを照会します。
作成で返されたタスク ID を保存し、同じサイトの API Key で照会します。ポーリングの停止は生成のキャンセルではありません。
GET
/v1/video/generations/{task_id}プラットフォーム作成で返された ID で現在のユーザーのタスクを照会します。クライアントのポーリング停止は生成のキャンセルではありません。
照会結果の読み方
プラットフォーム照会は code/message/data 形式で返り、data は単一タスクです。code: "success" は照会リクエストの成功を示します。生成完了は data.status で判断してください。
| 状況 | 意味と対処 |
|---|---|
HTTP 200、data.status: "processing" | 処理中。data.url は空文字列の場合があります。後で再照会 |
HTTP 200、data.status: "succeeded" | 生成成功。data.url から URL を取得し、速やかに保存 |
HTTP 400、code: "task_not_exist" | タスクが見つかりません。タスク ID、API Key、サイトを確認 |
HTTP 401、Invalid token | Bearer 形式と API Key の所属サイトを確認。未指定・無効な Key は同じエラーの場合あり |
data.error と data.metadata は null の場合があります。プラットフォーム形式はネイティブ照会の data[] と異なります。ネイティブフィールドと定価情報はネイティブ照会 API を参照してください。
HTTP 400/401 は照会リクエストのエラーであり、生成タスクの失敗とは異なります。正常なタスクオブジェクトがない場合があるため、URL の読み取りやポーリングを続ける前にエラーを解消してください。