Skip to main content
GET
Utilizza questa famiglia di endpoint dopo aver creato un’attività Kling. È il passaggio di polling comune per i processi multimediali asincroni di Kling.
Una query può restituire l’oggetto attività direttamente oppure all’interno del contenitore standard data envelope. Normalizza ogni risposta con task = payload.data ?? payload prima di leggere i campi dell’attività.

​
Cosa verificare per prima cosa

  • task.task_status; le attività Motion Control utilizzano submitted, processing, succeed, oppure failed
  • task.task_result.videos[0].url quando un’attività video viene completata con successo
  • task.task_status_msg oppure altri campi di dettaglio restituiti quando un’attività si interrompe anticipatamente
  • code, message, e request_id quando la risposta utilizza lo standard envelope

​
Schema di polling

1

Crea l'attività dall'endpoint corrispondente

Inizia dalla pagina di creazione Kling per il tuo flusso di lavoro, ad esempio Da testo a video, Da immagine a video, oppure Motion Control.
2

Esegui il polling finché l'attività non raggiunge uno stato terminale

Normalizza la struttura della risposta, quindi continua a eseguire query con l’ID dell’attività restituito finché non raggiunge uno stato terminale. Per Motion Control, gli stati terminali sono succeed e failed.
3

Prosegui al passaggio successivo del flusso di lavoro

Utilizza direttamente l’output completato oppure passa alla pagina dell’azione successiva applicabile se il tuo flusso di lavoro supporta operazioni concatenate.

​
Coppie di percorsi comuni

Per il riferimento completo dei parametri, consulta la documentazione ufficiale di Kling.

Autorizzazioni

​
Authorization
string
header
obbligatorio

Bearer token authentication. Use your CometAPI key.

Parametri del percorso

​
action
string
obbligatorio

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

​
action2
string
obbligatorio

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
obbligatorio

Task ID

Risposta

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
obbligatorio

Kling task ID.

​
task_status
string
obbligatorio

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.

Ultima modifica il 31 luglio 2026