Gebruik Kling callback-URL's

​

Waar je het gebruikt

• Tekst-naar-video- en afbeelding-naar-video-taken
• Avatar- en video-effectentaken
• Andere asynchrone Kling-routes die een optioneel veld callback_url beschikbaar maken

​

Leveringsgedrag

• 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 afstemming, 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"
      }
    ]
  }
}