> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Usar URLs de callback de Kling

> Configura `callback_url` de Kling en CometAPI para recibir actualizaciones de estado y payloads de resultados de tareas asíncronas de video/imagen (de submitted a succeed/failed).

Usa `callback_url` en tareas asíncronas de Kling cuando quieras entrega por envío automático en lugar de solo polling.

## 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 solicitudes a tu endpoint de callback cada vez que cambia el estado de una 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
* Guarda rápidamente las URL finales de los recursos si tu flujo de trabajo necesita almacenamiento duradero

```jsonc theme={null}
{
  "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"
      }
    ]
  }
}
```