URL Callback

​

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