Skip to main content
GET
Use esta família de endpoints depois de criar uma tarefa do Kling. Esta é a etapa comum de polling para jobs assíncronos de mídia do Kling.

​
O que verificar primeiro

  • code, message e request_id para o reconhecimento da consulta
  • data.task_status para o estado da tarefa, como submitted, processing, succeed ou failed
  • data.task_result.videos[0].url quando a tarefa for bem-sucedida
  • data.task_status_msg ou outros campos de detalhe retornados quando uma tarefa for interrompida antes da conclusão

​
Padrão de polling

1

Criar a tarefa a partir do endpoint correspondente

Comece pela página de criação do Kling para o seu fluxo de trabalho, como Text to Video ou Image to Video.
2

Fazer polling até a tarefa chegar a um estado terminal

Continue consultando com o id da tarefa retornado até que data.task_status alcance succeed ou failed.
3

Continuar para a próxima etapa do fluxo de trabalho

Use a saída finalizada diretamente ou avance para a próxima página de ação específica do provedor se o seu fluxo de trabalho oferecer suporte a operações encadeadas.

​
Pares de caminho comuns

Para a referência completa de parâmetros, consulte a documentação oficial do Kling.

Autorizações

​
Authorization
string
header
obrigatório

Bearer token authentication. Use your CometAPI key.

Parâmetros de caminho

​
action
string
obrigatório

Resource type. One of: images, videos, audio.

​
action2
string
obrigatório

Sub-action matching the resource type. For images: generations, kolors-virtual-try-on. For videos: text2video, image2video, lip-sync, effects, multi-image2video, multi-elements. For audio: text-to-audio, video-to-audio.

​
task_id
string
obrigatório

Task ID

Resposta

200 - application/json

Current Kling task state.

​
code
integer
obrigatório

Kling response code. 0 indicates the query was accepted.

​
message
string
obrigatório

Kling response message.

​
request_id
string
obrigatório

Identifier for this query request.

​
data
object
obrigatório