Kling タスクを取得

GET

kling

{action}

{action2}

{task_id}

curl "https://api.cometapi.com/kling/v1/videos/text2video/<task_id>" \
  -H "Authorization: Bearer $COMETAPI_KEY"

{
  "task_id": "<task_id>",
  "task_status": "submitted",
  "task_info": {},
  "created_at": 1781080355827,
  "updated_at": 1781080355827
}

Kling タスクを作成した後に、このエンドポイントファミリーを使用します。これは Kling の非同期メディアジョブに共通するポーリング手順です。

クエリでは、タスクオブジェクトが直接返される場合も、標準の data エンベロープ内に含まれて返される場合もあります。タスクフィールドを読み取る前に、各レスポンスを task = payload.data ?? payload で正規化します。タスクフィールドを読み取ります。

最初に確認する項目

task.task_status；Motion Control タスクでは submitted、processing、 succeedまたは failed
task.task_result.videos[0].url ビデオタスクが成功した場合
task.task_status_msg またはタスクが早期に停止した場合は、返されたその他の詳細フィールド
code, message、および request_id。レスポンスで標準のエンベロープが使用される場合に確認します。

ポーリングパターン

対応するエンドポイントからタスクを作成する

Text to Video など、ワークフローに対応する Kling の作成ページから開始します。テキストから動画, 画像から動画、または Motion Control.

タスクが終端状態になるまでポーリングする

レスポンス形式を正規化してから、返されたタスク ID を使用してクエリを続けます終端状態に達するまで続けます。Motion Control では、終端状態は succeed と failed です。

次のワークフローステップに進む

完了した出力を直接使用するか、ワークフローが連鎖操作をサポートしている場合は、該当する次のアクションページに進みます。

一般的なパスの組み合わせ

ワークフロー	クエリパス
テキストから動画	`/kling/v1/videos/text2video/{task_id}`
画像から動画	`/kling/v1/videos/image2video/{task_id}`
Motion Control	`/kling/v1/videos/motion-control/{task_id}`
複数画像から動画	`/kling/v1/videos/multi-image2video/{task_id}`
動画エフェクト	`/kling/v1/videos/effects/{task_id}`
動画拡張	`/kling/v1/videos/video-extend/{task_id}`
アバター動画	`/kling/v1/videos/avatar/image2video/{task_id}`

完全なパラメータリファレンスについては、 Kling 公式ドキュメント.

承認

Authorization

string

header

必須

Bearer token authentication. Use your CometAPI key.

パスパラメータ

action

string

必須

Resource type. One of: images, videos, audio.

action2

string

必須

Sub-action matching the resource type. For images: generations, kolors-virtual-try-on. For videos: text2video, image2video, motion-control, lip-sync, effects, multi-image2video, multi-elements. For audio: text-to-audio, video-to-audio.

task_id

string

必須

Task ID

レスポンス

200 - application/json

Current Kling task state.

Option 1
Option 2

A query can return the task object directly or inside the standard response envelope. Normalize both shapes before reading task fields.

task_id

string

必須

Kling task ID.

task_status

string

必須

Current task state. Compatible Motion Control tasks use submitted, processing, succeed, or failed.

task_status_msg

string

Failure or status detail when returned.

task_info

object

Additional task metadata. The object can be empty.

task_result

object

Absent on an initial submitted task, commonly empty while processing or after failure, and populated when a task succeeds.

Show child attributes

watermark_info

object

Watermark information when returned by a compatible workflow.

Show child attributes

created_at

integer<int64>

Task creation timestamp in milliseconds.

updated_at

integer<int64>

Last task update timestamp in milliseconds.

final_unit_deduction

string

Final unit deduction value, when returned.

final_balance_deduction

object

Final balance deduction values, when returned.

Show child attributes

最終更新日 2026年7月31日

curl "https://api.cometapi.com/kling/v1/videos/text2video/<task_id>" \
  -H "Authorization: Bearer $COMETAPI_KEY"

{
  "task_id": "<task_id>",
  "task_status": "submitted",
  "task_info": {},
  "created_at": 1781080355827,
  "updated_at": 1781080355827
}

コンテンツモデレーション

APIキー

最初に確認する項目

ポーリングパターン

一般的なパスの組み合わせ

承認

パスパラメータ

レスポンス

​最初に確認する項目

​ポーリングパターン

​一般的なパスの組み合わせ

承認

パスパラメータ

レスポンス

最初に確認する項目

ポーリングパターン

一般的なパスの組み合わせ