> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Obtener una tarea de Kling
> Consulta tareas de generación de video de Kling por task_id mediante GET /kling/v1/{action}/{action2}/{task_id}, devolviendo estado, progreso y metadatos del resultado para el polling.
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
Comienza con la página de creación de Kling para tu flujo de trabajo, como [Text to Video](./text-to-video) o [Image to Video](./image-to-video).
Sigue consultando con el task id devuelto hasta que `data.task_status` llegue a `succeed` o `failed`.
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](https://docs.qingque.cn/d/home/eZQClW07IFEuX1csc-VejdY2M).
## OpenAPI
````yaml api/openapi/video/kling/get-individual-queries.openapi.json GET /kling/v1/{action}/{action2}/{task_id}
openapi: 3.1.0
info:
title: Individual queries API
version: 1.0.0
servers:
- url: https://api.cometapi.com
security:
- bearerAuth: []
paths:
/kling/v1/{action}/{action2}/{task_id}:
get:
summary: 'Individual queries '
description: >-
The example uses `videos/text2video`; substitute the action segments
that match your task type, such as `images/generations` or
`audio/text-to-audio`.
operationId: individual_queries
parameters:
- name: action
in: path
required: true
description: 'Resource type. One of: `images`, `videos`, `audio`.'
schema:
type: string
- name: action2
in: path
required: true
description: >-
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`.
schema:
type: string
- name: task_id
in: path
required: true
description: Task ID
schema:
type: string
responses:
'200':
description: Current Kling task state.
content:
application/json:
schema:
type: object
required:
- code
- message
- request_id
- data
properties:
code:
type: integer
description: Kling response code. 0 indicates the query was accepted.
message:
type: string
description: Kling response message.
request_id:
type: string
description: Identifier for this query request.
data:
type: object
required:
- task_id
- task_status
- task_info
- created_at
- updated_at
properties:
task_id:
type: string
description: Kling task id.
task_status:
type: string
description: Current task state.
enum:
- submitted
- processing
- succeed
- failed
task_status_msg:
type: string
description: Failure or status detail when returned.
task_info:
type: object
description: Additional task metadata. The object can be empty.
additionalProperties: true
task_result:
type: object
description: >-
Result metadata. Present as an empty object while
processing and populated on success.
properties:
videos:
type: array
description: Generated videos.
items:
type: object
properties:
id:
type: string
description: Generated video id.
url:
type: string
description: Generated video URL.
duration:
type: string
description: Video duration in seconds.
additionalProperties: true
created_at:
type: integer
description: Task creation timestamp in milliseconds.
updated_at:
type: integer
description: Last task update timestamp in milliseconds.
final_unit_deduction:
type: string
description: >-
Final unit deduction returned after a successful task,
when available.
examples:
Processing:
summary: Task still rendering
value:
code: 0
message: SUCCEED
request_id:
data:
task_id:
task_status: processing
task_info: {}
task_result: {}
created_at: 1781080355827
updated_at: 1781080362336
Succeed:
summary: Finished task with video result
value:
code: 0
message: SUCCEED
data:
task_id:
task_status: succeed
task_info: {}
created_at: 1781074110938
updated_at: 1781074171088
task_result:
videos:
- id:
url: https://storage.fonedis.cc/.../video.mp4
duration: '5.1'
x-codeSamples:
- lang: Shell
label: Default
source: >
TASK_ID=""
curl "https://api.cometapi.com/kling/v1/videos/text2video/$TASK_ID"
\
-H "Authorization: Bearer $COMETAPI_KEY"
- lang: Shell
label: Poll until done
source: |
TASK_ID=""
while true; do
STATUS=$(curl -s "https://api.cometapi.com/kling/v1/videos/text2video/$TASK_ID" \
-H "Authorization: Bearer $COMETAPI_KEY" | python3 -c "import json,sys; print(json.load(sys.stdin)['data']['task_status'])")
echo "status: $STATUS"
case "$STATUS" in succeed | failed) break;; esac
sleep 30
done
- lang: Python
label: Default
source: |
import os
import requests
task_id = ""
response = requests.get(
f"https://api.cometapi.com/kling/v1/videos/text2video/{task_id}",
headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]},
)
print(response.json()["data"]["task_status"])
- lang: Python
label: Poll until done
source: |
import os
import time
import requests
task_id = ""
headers = {"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]}
while True:
data = requests.get(
f"https://api.cometapi.com/kling/v1/videos/text2video/{task_id}", headers=headers
).json()["data"]
print(data["task_status"])
if data["task_status"] in ("succeed", "failed"):
break
time.sleep(30)
if data["task_status"] == "succeed":
print(data["task_result"])
- lang: JavaScript
label: Default
source: >
const taskId = "";
const response = await
fetch(`https://api.cometapi.com/kling/v1/videos/text2video/${taskId}`,
{
headers: { Authorization: `Bearer ${process.env.COMETAPI_KEY}` },
});
const result = await response.json();
console.log(result.data.task_status);
- lang: JavaScript
label: Poll until done
source: >
const taskId = "";
const headers = { Authorization: `Bearer
${process.env.COMETAPI_KEY}` };
let data;
while (true) {
data = (await (await fetch(`https://api.cometapi.com/kling/v1/videos/text2video/${taskId}`, { headers })).json()).data;
console.log(data.task_status);
if (data.task_status === "succeed" || data.task_status === "failed") break;
await new Promise((resolve) => setTimeout(resolve, 30000));
}
if (data.task_status === "succeed") console.log(data.task_result);
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: Bearer token authentication. Use your CometAPI key.
````