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 adicionarcallback_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: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 umdata.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 formato da resposta é diferente das rotas de vídeo da OpenAI
O formato da resposta é diferente das rotas de vídeo da OpenAI
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.A tarefa nunca chega a succeed
A tarefa nunca chega a succeed
Use polling com limite e inspecione
data.task_status_msg quando uma tarefa falhar. Armazene o ID da tarefa para diagnósticos posteriores.Devo usar callback_url ou polling
Devo usar callback_url ou polling
Use polling como base. Adicione
callback_url para entrega por push e, em seguida, reconcilie o estado final com polling.Próximos passos
- Leia a referência da API de texto para vídeo do Kling.
- Faça polling com Obter uma tarefa do Kling.
- Configure callbacks com Usar URLs de callback do Kling.
- Encontre modelos de vídeo do Kling em Models.
- Consulte Usar polling e webhooks para geração de vídeo.
- Estime o custo da tarefa com Estimar o custo da solicitação antes de chamar um modelo.