Naar hoofdinhoud gaan
Gebruik callback_url bij Kling async-taken wanneer je push delivery wilt in plaats van alleen polling.

​
Waar je het gebruikt

  • Tekst-naar-video- en afbeelding-naar-videotaken
  • Avatar- en video-effecttaken
  • Andere Kling async-routes die een optioneel veld callback_url beschikbaar maken

​
Delivery-gedrag

  • Kling post naar je callback-endpoint wanneer de taakstatus verandert
  • Veelvoorkomende statussen zijn submitted, processing, succeed en failed
  • De payload kan task_result.images of task_result.videos bevatten, afhankelijk van het taaktype
  • Houd handmatige polling beschikbaar voor reconciliatie, retries of het afhandelen van gemiste webhooks

​
Integratiechecklist

  • Gebruik een HTTPS-callback-endpoint dat je beheert
  • Accepteer herhaalde statusupdates voor dezelfde task id
  • Behandel webhook-delivery als asynchroon en uiteindelijk consistent
  • Sla de definitieve asset-URL’s snel op als je workflow duurzame opslag nodig heeft
{
  "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"
      }
    ]
  }
}