Obtener una tarea de Kling

GET

kling

{action}

{action2}

{task_id}

TASK_ID="<task_id>"

curl "https://api.cometapi.com/kling/v1/videos/text2video/$TASK_ID" \
  -H "Authorization: Bearer $COMETAPI_KEY"

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "<task_id>",
  "data": {
    "task_id": "<task_id>",
    "task_status": "processing",
    "task_info": {},
    "task_result": {},
    "created_at": 1781080355827,
    "updated_at": 1781080362336
  }
}

Usa esta familia de endpoints después de crear una tarea de Kling. Es el paso de polling habitual para los trabajos asíncronos de medios de Kling.

Qué comprobar primero

code, message y request_id para la confirmación de la consulta
data.task_status para el estado de la tarea, como submitted, processing, succeed o failed
data.task_result.videos[0].url cuando la tarea finaliza correctamente
data.task_status_msg u otros campos de detalle devueltos cuando una tarea se detiene antes de tiempo

Patrón de polling

Crear la tarea desde el endpoint correspondiente

Comienza con la página de creación de Kling para tu flujo de trabajo, como Text to Video o Image to Video.

Hacer polling hasta que la tarea termine

Sigue consultando con el task id devuelto hasta que data.task_status llegue a succeed o failed.

Continuar con el siguiente paso del flujo de trabajo

Usa directamente el resultado final, o pasa a la siguiente página de acción específica del proveedor si tu flujo de trabajo admite operaciones encadenadas.

Pares de rutas comunes

Flujo de trabajo	Ruta de consulta
Text to video	`/kling/v1/videos/text2video/{task_id}`
Image to video	`/kling/v1/videos/image2video/{task_id}`
Video de múltiples imágenes	`/kling/v1/videos/multi-image2video/{task_id}`
Efectos de video	`/kling/v1/videos/effects/{task_id}`
Extensión de video	`/kling/v1/videos/video-extend/{task_id}`
Video de avatar	`/kling/v1/videos/avatar/image2video/{task_id}`

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, 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.

code

integer

requerido

Kling response code. 0 indicates the query was accepted.

message

string

requerido

Kling response message.

request_id

string

requerido

Identifier for this query request.

data

object

requerido

Show child attributes

Reconocer imágenes con Kling

Crear un video Kling Omni

TASK_ID="<task_id>"

curl "https://api.cometapi.com/kling/v1/videos/text2video/$TASK_ID" \
  -H "Authorization: Bearer $COMETAPI_KEY"

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "<task_id>",
  "data": {
    "task_id": "<task_id>",
    "task_status": "processing",
    "task_info": {},
    "task_result": {},
    "created_at": 1781080355827,
    "updated_at": 1781080362336
  }
}

Moderación de contenido

Claves API

Qué comprobar primero

Patrón de polling

Pares de rutas comunes

Autorizaciones

Parámetros de ruta

Respuesta

​Qué comprobar primero

​Patrón de polling

​Pares de rutas comunes

Autorizaciones

Parámetros de ruta

Respuesta

Qué comprobar primero

Patrón de polling

Pares de rutas comunes