> ## 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.
# Obtenir une tâche Kling
> Interrogez les tâches de génération vidéo Kling par task_id via GET /kling/v1/{action}/{action2}/{task_id}, avec retour du statut, de la progression et des métadonnées de résultat pour le polling.
Utilisez cette famille d’endpoint après avoir créé une tâche Kling. C’est l’étape de polling courante pour les tâches média asynchrones de Kling.
## Ce qu’il faut vérifier d’abord
* `code`, `message` et `request_id` pour l’accusé de réception de la requête
* `data.task_status` pour l’état de la tâche, comme `submitted`, `processing`, `succeed` ou `failed`
* `data.task_result.videos[0].url` lorsque la tâche réussit
* `data.task_status_msg` ou d’autres champs de détail renvoyés lorsqu’une tâche s’arrête prématurément
## Modèle de polling
Commencez par la page de création Kling adaptée à votre workflow, comme [Text to Video](./text-to-video) ou [Image to Video](./image-to-video).
Continuez à interroger avec l’id de tâche renvoyé jusqu’à ce que `data.task_status` atteigne `succeed` ou `failed`.
Utilisez directement la sortie finale, ou passez à la page d’action spécifique au fournisseur suivante si votre workflow prend en charge les opérations enchaînées.
## Paires de chemins courantes
| Workflow | Chemin de requête |
| ------------------ | ----------------------------------------------- |
| Text to video | `/kling/v1/videos/text2video/{task_id}` |
| Image to video | `/kling/v1/videos/image2video/{task_id}` |
| Vidéo multi-images | `/kling/v1/videos/multi-image2video/{task_id}` |
| Effets vidéo | `/kling/v1/videos/effects/{task_id}` |
| Extension vidéo | `/kling/v1/videos/video-extend/{task_id}` |
| Vidéo avatar | `/kling/v1/videos/avatar/image2video/{task_id}` |
Pour la référence complète des paramètres, consultez la [documentation officielle 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.
````