Saltar para o conteúdo principal
Use callback_url em tarefas assíncronas do Kling quando quiser entrega por push em vez de apenas polling.

​
Onde usar

  • 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 opcional callback_url

​
Comportamento de entrega

  • O Kling faz POST para 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, novas tentativas 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 precisar de armazenamento durável
{
  "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"
      }
    ]
  }
}