URL de callback

​

Dónde usarlo

• Tareas de texto a video y de imagen a video
• Tareas de avatar y efectos de video
• Otras rutas asíncronas de Kling que exponen un campo opcional callback_url

​

Comportamiento de entrega

• Kling envía una solicitud POST a tu endpoint de callback cada vez que cambia el estado de la tarea
• Los estados comunes son submitted, processing, succeed y failed
• El payload puede incluir task_result.images o task_result.videos según el tipo de tarea
• Mantén disponible el polling manual para conciliación, reintentos o manejo de webhooks perdidos

​

Lista de verificación de integración

• Usa un endpoint de callback HTTPS que controles
• Acepta actualizaciones de estado repetidas para el mismo id de tarea
• Trata la entrega del webhook como asíncrona y eventualmente consistente
• Persiste rápidamente las URL finales de los recursos si tu flujo de trabajo necesita almacenamiento duradero

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