Passer au contenu principal
Utilisez callback_url sur les tâches asynchrones Kling lorsque vous souhaitez une livraison push plutôt qu’un simple polling.

​
Où l’utiliser

  • Tâches de text-to-video et d’image-vers-vidéo
  • Tâches d’avatar et d’effets vidéo
  • Autres routes asynchrones Kling qui exposent un champ callback_url optionnel

​
Comportement de livraison

  • Kling envoie des requêtes POST à votre endpoint de callback chaque fois que l’état de la tâche change
  • Les états courants sont submitted, processing, succeed et failed
  • Le payload peut inclure task_result.images ou task_result.videos selon le type de tâche
  • Conservez le polling manuel comme solution de rapprochement, de retry ou de gestion des webhooks manqués

​
Checklist d’intégration

  • Utilisez un endpoint de callback HTTPS que vous contrôlez
  • Acceptez les mises à jour d’état répétées pour le même id de tâche
  • Traitez la livraison du webhook comme asynchrone et à cohérence éventuelle
  • Persistez rapidement les URL finales des assets si votre workflow nécessite un stockage durable
{
  "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"
      }
    ]
  }
}