Skip to main content
GET
Użyj tej rodziny endpointów po utworzeniu zadania Kling. Jest to standardowy krok odpytywania dla asynchronicznych zadań multimedialnych Kling.
Zapytanie może zwrócić obiekt zadania bezpośrednio lub wewnątrz standardowej data otoczki. Normalizuj każdą odpowiedź za pomocą task = payload.data ?? payload przed odczytaniem pól zadania.

​
Co sprawdzić najpierw

  • task.task_status; zadania Motion Control używają submitted, processing, succeed, lub failed
  • task.task_result.videos[0].url gdy zadanie wideo zakończy się powodzeniem
  • task.task_status_msg lub innych zwróconych pól szczegółowych, gdy zadanie zakończy się przedwcześnie
  • code, message, oraz request_id, gdy odpowiedź używa standardowej otoczki

​
Wzorzec odpytywania

1

Utwórz zadanie z odpowiedniego endpointu

Zacznij od strony tworzenia Kling dla swojego przepływu pracy, na przykład Tekst na wideo, Obraz na wideo, lub Motion Control.
2

Odpytuj do osiągnięcia stanu końcowego zadania

Normalizuj strukturę odpowiedzi, a następnie kontynuuj odpytywanie, używając zwróconego identyfikatora zadania aż osiągnie ono stan końcowy. W przypadku Motion Control stany końcowe to succeed i failed.
3

Przejdź do następnego kroku przepływu pracy

Użyj ukończonego wyniku bezpośrednio lub przejdź do kolejnej odpowiedniej strony działania, jeśli Twój przepływ pracy obsługuje operacje łańcuchowe.

​
Typowe pary ścieżek

Pełne informacje o parametrach znajdziesz w oficjalnej dokumentacji Kling.

Autoryzacje

​
Authorization
string
header
wymagane

Bearer token authentication. Use your CometAPI key.

Parametry ścieżki

​
action
string
wymagane

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

​
action2
string
wymagane

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
wymagane

Task ID

Odpowiedź

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
wymagane

Kling task ID.

​
task_status
string
wymagane

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.