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 tarefas assíncronas de mídia do Kling.
Uma consulta pode retornar o objeto da tarefa diretamente ou dentro do envelope data padrão Normalize cada resposta com task = payload.data ?? payload antes de ler os campos da tarefa.

​
O que verificar primeiro

  • task.task_status; as tarefas de Controle de movimento usam submitted, processing, succeed, ou failed
  • task.task_result.videos[0].url quando uma tarefa de vídeo é concluída com êxito
  • task.task_status_msg ou outros campos de detalhes retornados quando uma tarefa é interrompida antecipadamente
  • code, message, e request_id quando a resposta usar o envelope padrão

​
Padrão de polling

1

Crie a tarefa no endpoint correspondente

Comece pela página de criação do Kling para seu fluxo de trabalho, como Texto para vídeo, Imagem para vídeo, ou Controle de movimento.
2

Faça polling até a tarefa atingir um estado terminal

Normalize o formato da resposta e continue consultando com o ID da tarefa retornado até que ela atinja um estado terminal. Para Controle de movimento, os estados terminais são succeed e failed.
3

Continue para a próxima etapa do fluxo de trabalho

Use a saída concluída diretamente ou passe para a próxima página de ação aplicável se seu fluxo de trabalho oferecer suporte a operações encadeadas.

​
Pares de caminhos comuns

Para a referência completa dos 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, motion-control, 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.

A query can return the task object directly or inside the standard response envelope. Normalize both shapes before reading task fields.

​
task_id
string
obrigatório

Kling task ID.

​
task_status
string
obrigatório

Current task state. Compatible Motion Control tasks use submitted, processing, succeed, or failed.

​
task_status_msg
string

Failure or status detail when returned.

​
task_info
object

Additional task metadata. The object can be empty.

​
task_result
object

Absent on an initial submitted task, commonly empty while processing or after failure, and populated when a task succeeds.

​
watermark_info
object

Watermark information when returned by a compatible workflow.

​
created_at
integer<int64>

Task creation timestamp in milliseconds.

​
updated_at
integer<int64>

Last task update timestamp in milliseconds.

​
final_unit_deduction
string

Final unit deduction value, when returned.

​
final_balance_deduction
object

Final balance deduction values, when returned.

Última modificação em 31 de julho de 2026