Skip to main content
GET
Usa esta familia de endpoints después de crear una tarea de Kling. Es el paso de sondeo habitual para los trabajos de medios asíncronos de Kling.
Una consulta puede devolver el objeto de tarea directamente o dentro del sobre estándar data sobre. Normaliza cada respuesta con task = payload.data ?? payload antes de leer los campos de la tarea.

​
Qué comprobar primero

  • task.task_status; las tareas de Motion Control usan submitted, processing, succeed, o failed
  • task.task_result.videos[0].url cuando una tarea de video se completa correctamente
  • task.task_status_msg u otros campos de detalle devueltos cuando una tarea finaliza antes de tiempo
  • code, message, y request_id cuando la respuesta usa el sobre estándar sobre

​
Patrón de sondeo

1

Crea la tarea desde el endpoint correspondiente

Comienza con la página de creación de Kling correspondiente a tu flujo de trabajo, como Texto a video, Imagen a video, o Motion Control.
2

Sondea hasta que la tarea alcance un estado terminal

Normaliza la estructura de la respuesta y, luego, sigue consultando con el ID de tarea devuelto hasta que alcance un estado terminal. Para Motion Control, los estados terminales son succeed y failed.
3

Continúa con el siguiente paso del flujo de trabajo

Usa directamente la salida finalizada o pasa a la siguiente página de acción aplicable si tu flujo de trabajo admite operaciones encadenadas.

​
Pares de rutas habituales

Para consultar la referencia completa de parámetros, consulta la documentación oficial de Kling.

Autorizaciones

​
Authorization
string
header
requerido

Bearer token authentication. Use your CometAPI key.

Parámetros de ruta

​
action
string
requerido

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

​
action2
string
requerido

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
requerido

Task ID

Respuesta

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
requerido

Kling task ID.

​
task_status
string
requerido

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 modificación el 31 de julio de 2026