> ## 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 do Kling

> Configure o `callback_url` do Kling no CometAPI para receber atualizações assíncronas de status de tarefas de vídeo/imagem e payloads de resultados (de submitted a succeed/failed).

Use `callback_url` em tarefas assíncronas do Kling quando quiser entrega por push em vez de apenas polling.

## Onde usá-lo

* Tarefas de texto para vídeo e de imagem para vídeo
* Tarefas de avatar e efeitos de vídeo
* Outras rotas assíncronas do Kling que expõem um campo `callback_url` opcional

## Comportamento de entrega

* O Kling envia uma solicitação para o seu endpoint de callback sempre que o status da tarefa muda
* Os status comuns são `submitted`, `processing`, `succeed` e `failed`
* O payload pode incluir `task_result.images` ou `task_result.videos`, dependendo do tipo de tarefa
* Mantenha o polling manual disponível para reconciliação, tentativas novamente ou tratamento de webhooks perdidos

## Checklist de integração

* Use um endpoint de callback HTTPS sob seu controle
* Aceite atualizações de status repetidas para o mesmo id de tarefa
* Trate a entrega do webhook como assíncrona e eventualmente consistente
* Persista rapidamente as URLs finais dos assets se o seu fluxo de trabalho precisar de armazenamento durável

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