Skip to main content

O que você vai criar

Você enviará uma tarefa Kling de texto para vídeo, armazenará o ID da tarefa retornado, consultará o endpoint da tarefa Kling correspondente e decidirá quando adicionar callback_url para notificações push.

Pré-requisitos

  • Uma chave de API da CometAPI armazenada em COMETAPI_KEY
  • Python 3.10+ com requests, ou Node.js 18+
  • Um worker no servidor para polling ou um endpoint de callback HTTPS para webhooks

Chave de API, URL base, autenticação

Crie uma tarefa Kling de texto para vídeo com:
Consulte a tarefa com:
Autentique com um token Bearer:

Exemplos de código

Use as abas abaixo para exemplos copiáveis em cURL, Python e Node.js.

Explicação do fluxo

A geração de vídeo do Kling é assíncrona. O endpoint de criação retorna um data.task_id. Faça polling em GET /kling/v1/videos/text2video/<task_id> até que data.task_status alcance succeed ou failed. Quando a tarefa for concluída com sucesso, copie a URL final do recurso de data.task_result para o seu próprio armazenamento, caso precise de acesso durável. Adicione callback_url quando quiser que as atualizações de status da tarefa sejam enviadas para um endpoint HTTPS sob seu controle. Mantenha o polling disponível para reconciliação e para casos de falha na entrega do callback.

Parâmetros comuns

Solução de problemas / FAQ

O Kling usa campos JSON específicos do provedor, como data.task_id, data.task_status e data.task_result. Não faça o parse como nas rotas compatíveis com OpenAI /v1/videos.
Use polling com limite e inspecione data.task_status_msg quando uma tarefa falhar. Armazene o ID da tarefa para diagnósticos posteriores.
Use polling como base. Adicione callback_url para entrega por push e, em seguida, reconcilie o estado final com polling.

Próximos passos