> ## 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.

# Usare gli URL di callback di Kling

> Configura `callback_url` di Kling in CometAPI per ricevere aggiornamenti di stato e payload dei risultati per attività video/immagine asincrone (da submitted a succeed/failed).

Usa `callback_url` nelle attività asincrone di Kling quando vuoi una consegna push invece del solo polling.

## Dove usarlo

* Attività text-to-video e image-to-video
* Attività di avatar e video-effects
* Altre route asincrone di Kling che espongono un campo `callback_url` opzionale

## Comportamento di consegna

* Kling invia una richiesta POST al tuo endpoint di callback ogni volta che cambia lo stato dell'attività
* Gli stati comuni sono `submitted`, `processing`, `succeed` e `failed`
* Il payload può includere `task_result.images` o `task_result.videos` a seconda del tipo di attività
* Mantieni disponibile anche il polling manuale per riconciliazione, retry o gestione di webhook mancati

## Checklist di integrazione

* Usa un endpoint di callback HTTPS sotto il tuo controllo
* Accetta aggiornamenti di stato ripetuti per lo stesso id attività
* Considera la consegna del webhook come asincrona ed eventualmente consistente
* Salva rapidamente gli URL finali delle risorse se il tuo flusso di lavoro richiede uno storage durevole

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