Skip to main content
GET
Bruk denne endepunktfamilien etter at du har opprettet en Kling-oppgave. Dette er det vanlige pollingtrinnet for asynkrone Kling-mediejobber.
En spørring kan returnere oppgaveobjektet direkte eller i standard data innpakning. Normaliser hvert svar med task = payload.data ?? payload før du leser oppgavefeltene.

​
Hva du bør kontrollere først

  • task.task_status; Motion Control-oppgaver bruker submitted, processing, succeed, eller failed
  • task.task_result.videos[0].url når en videooppgave lykkes
  • task.task_status_msg eller andre returnerte detaljfelt når en oppgave avsluttes tidlig
  • code, message, og request_id når svaret bruker standard innpakning

​
Mønster for polling

1

Opprett oppgaven fra det tilsvarende endepunktet

Start med Kling-opprettelsessiden for arbeidsflyten din, for eksempel Text to Video, Image to Video, eller Motion Control.
2

Spørr etter oppgaven til den når en terminaltilstand

Normaliser svarformatet, og fortsett deretter å spørre med den returnerte oppgave-ID-en til den når en terminaltilstand. For Motion Control er terminaltilstandene succeed og failed.
3

Fortsett til neste trinn i arbeidsflyten

Bruk det ferdige resultatet direkte, eller gå videre til neste relevante handlingsside hvis arbeidsflyten din støtter kjedede operasjoner.

​
Vanlige kombinasjoner av stier

Du finner den fullstendige parameterreferansen i den offisielle Kling-dokumentasjonen.

Autorisasjoner

​
Authorization
string
header
påkrevd

Bearer token authentication. Use your CometAPI key.

Stien-parametere

​
action
string
påkrevd

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

​
action2
string
påkrevd

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
påkrevd

Task ID

Svar

200 - application/json

Current Kling task state.

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

​
task_id
string
påkrevd

Kling task ID.

​
task_status
string
påkrevd

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.

​
watermark_info
object

Watermark information when returned by a compatible workflow.

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

Sist endret 31. juli 2026