URL Callback

Gunakan callback_url pada tugas async Kling saat Anda ingin pengiriman push alih-alih hanya polling.

Di mana menggunakannya

Tugas text-to-video dan image-to-video
Tugas avatar dan video-effects
Route async Kling lainnya yang mengekspos field callback_url opsional

Perilaku pengiriman

Kling melakukan POST ke endpoint callback Anda setiap kali status tugas berubah
Status yang umum adalah submitted, processing, succeed, dan failed
Payload dapat mencakup task_result.images atau task_result.videos tergantung pada jenis tugas
Tetap sediakan polling manual untuk rekonsiliasi, retry, atau penanganan webhook yang terlewat

Checklist integrasi

Gunakan endpoint callback HTTPS yang Anda kendalikan
Terima pembaruan status berulang untuk task id yang sama
Perlakukan pengiriman webhook sebagai asynchronous dan eventually consistent
Simpan URL aset final dengan cepat jika workflow Anda memerlukan penyimpanan yang tahan lama

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