> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Kling コールバック URL を使う

> CometAPI で Kling の callback_url を設定し、非同期の動画/画像タスクのステータス更新と結果ペイロード（submitted から succeed/failed まで）を受け取ります。

ポーリングだけでなくプッシュ配信を使いたい場合は、Kling の非同期タスクで `callback_url` を使用します。

## どこで使うか

* テキストから動画、および画像から動画へのタスク
* Avatar および動画エフェクトのタスク
* オプションの `callback_url` フィールドを公開しているその他の Kling 非同期ルート

## 配信の挙動

* タスクのステータスが変化するたびに、Kling はあなたのコールバックエンドポイントへ POST します
* 一般的なステータスは `submitted`、`processing`、`succeed`、`failed` です
* タスクの種類に応じて、ペイロードには `task_result.images` または `task_result.videos` が含まれる場合があります
* 突合、再試行、または取りこぼした webhook の処理のために、手動ポーリングも使えるようにしておいてください

## 統合チェックリスト

* 自分で管理している HTTPS のコールバックエンドポイントを使う
* 同じ task id に対する重複したステータス更新を受け付ける
* webhook 配信は非同期かつ結果整合性になるものとして扱う
* ワークフローで永続ストレージが必要な場合は、最終的なアセット URL をすばやく保存する

```jsonc theme={null}
{
  "task_id": "string",
  "task_status": "string",
  "task_status_msg": "string",
  "created_at": 1722769557708,
  "updated_at": 1722769557708,
  "task_result": {
    "images": [
      {
        "index": 0,
        "url": "https://example.com/generated-image.png"
      }
    ],
    "videos": [
      {
        "id": "string",
        "url": "https://example.com/generated-video.mp4",
        "duration": "5"
      }
    ]
  }
}
```