Obtenir une tâche Kling

GET

kling

{action}

{action2}

{task_id}

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

{
  "task_id": "<task_id>",
  "task_status": "submitted",
  "task_info": {},
  "created_at": 1781080355827,
  "updated_at": 1781080355827
}

Utilisez cette famille de points de terminaison après avoir créé une tâche Kling. Il s’agit de l’étape d’interrogation périodique courante pour les tâches multimédias asynchrones Kling.

Une requête peut renvoyer directement l’objet de tâche ou dans l’enveloppe standard data enveloppe. Normalisez chaque réponse avec task = payload.data ?? payload avant de lire les champs de la tâche.

Éléments à vérifier en premier

task.task_status; les tâches Motion Control utilisent submitted, processing, succeed, ou failed
task.task_result.videos[0].url lorsqu’une tâche vidéo réussit
task.task_status_msg ou d’autres champs de détail renvoyés lorsqu’une tâche s’arrête prématurément
code, message, et request_id lorsque la réponse utilise l’enveloppe standard enveloppe

Modèle d’interrogation périodique

Créez la tâche à partir du point de terminaison correspondant

Commencez par la page de création Kling correspondant à votre flux de travail, telle que Texte vers vidéo, Image vers vidéo, ou Motion Control.

Interrogez jusqu’à ce que la tâche atteigne un état terminal

Normalisez la structure de la réponse, puis continuez à interroger avec l’identifiant de tâche renvoyé jusqu’à ce qu’elle atteigne un état terminal. Pour Motion Control, les états terminaux sont succeed et failed.

Passez à l’étape suivante du flux de travail

Utilisez directement la sortie finalisée, ou passez à la page d’action applicable suivante si votre flux de travail prend en charge les opérations enchaînées.

Paires de chemins courantes

Flux de travail	Chemin de requête
Texte vers vidéo	`/kling/v1/videos/text2video/{task_id}`
Image vers vidéo	`/kling/v1/videos/image2video/{task_id}`
Motion Control	`/kling/v1/videos/motion-control/{task_id}`
Vidéo multi-images	`/kling/v1/videos/multi-image2video/{task_id}`
Effets vidéo	`/kling/v1/videos/effects/{task_id}`
Extension de vidéo	`/kling/v1/videos/video-extend/{task_id}`
Vidéo d’avatar	`/kling/v1/videos/avatar/image2video/{task_id}`

Pour la référence complète des paramètres, consultez la documentation officielle de Kling.

Autorisations

Authorization

string

header

requis

Bearer token authentication. Use your CometAPI key.

Paramètres de chemin

action

string

requis

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

action2

string

requis

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

requis

Task ID

Réponse

200 - application/json

Current Kling task state.

Option 1
Option 2

A query can return the task object directly or inside the standard response envelope. Normalize both shapes before reading task fields.

task_id

string

requis

Kling task ID.

task_status

string

requis

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.

Show child attributes

watermark_info

object

Watermark information when returned by a compatible workflow.

Show child attributes

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.

Show child attributes

Dernière modification le 31 juillet 2026

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

{
  "task_id": "<task_id>",
  "task_status": "submitted",
  "task_info": {},
  "created_at": 1781080355827,
  "updated_at": 1781080355827
}

Modération de contenu

Clés API

Éléments à vérifier en premier

Modèle d’interrogation périodique

Paires de chemins courantes

Autorisations

Paramètres de chemin

Réponse

​Éléments à vérifier en premier

​Modèle d’interrogation périodique

​Paires de chemins courantes

Autorisations

Paramètres de chemin

Réponse

Éléments à vérifier en premier

Modèle d’interrogation périodique

Paires de chemins courantes