Consultas individuales

Consulta tareas de generación de video de Kling por task_id mediante GET /kling/v1///, devolviendo estado, progreso y metadatos del resultado para polling.

GET /kling/v1/{action}/{action2}/{task_id}

Individual queries

cURL

curl --request GET \
  --url https://api.cometapi.com/kling/v1/{action}/{action2}/{task_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "code": 123,
  "message": "<string>",
  "request_id": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "<string>",
    "task_info": {
      "parent_video": {
        "id": "<string>",
        "url": "<string>",
        "duration": "<string>"
      }
    },
    "task_result": {
      "videos": [
        {
          "id": "<string>",
          "url": "<string>",
          "duration": "<string>"
        }
      ]
    },
    "created_at": 123,
    "updated_at": 123
  }
}

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

​

Qué comprobar primero

• Estado de la tarea o campos de progreso de la tarea devueltos por el wrapper
• Metadatos de salida o URLs de recursos cuando la tarea finaliza
• Mensajes de error específicos del proveedor cuando una tarea se detiene antes de tiempo

​

Patrón de polling

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

2. Hacer polling hasta que la tarea llegue a un estado terminal

   Sigue consultando con el id de tarea devuelto hasta que el estado alcance success o failure.

3. Continuar con el siguiente paso del flujo de trabajo

   Usa directamente la salida finalizada o pasa a la siguiente página de acciones específicas del proveedor si tu flujo de trabajo admite operaciones encadenadas.

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

Successful Response

code · integer · requerido

Return code

message · string · requerido

Text description of the request result

request_id · string · requerido

Unique identifier for this request

data · object · requerido

Object containing specific response data

Show child attributes