コールバックURL

​

使用する場所

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

​

配信の挙動

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

​

統合チェックリスト

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

{
  "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"
      }
    ]
  }
}