Usar URLs de callback do Kling

​

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

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