Bir Kling görevi alın

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
}

Bir Kling görevi oluşturduktan sonra bu endpoint ailesini kullanın. Kling eşzamansız medya işleri için ortak yoklama adımıdır.

Bir sorgu, görev nesnesini doğrudan veya standart data zarfı içinde döndürebilir. Her yanıtı task = payload.data ?? payload ile görev alanlarını okumadan önce normalleştirin.

Önce kontrol edilecekler

task.task_status; Motion Control görevleri submitted, processing, succeed, veya failed
task.task_result.videos[0].url bir video görevi başarılı olduğunda kullanır
task.task_status_msg ya da bir görev erken durduğunda döndürülen diğer ayrıntı alanlarını kullanır
code, message, ayrıca yanıt standart olduğunda request_id kullanır zarfını kullanır.

Yoklama düzeni

Görevi eşleşen endpoint'ten oluşturun

İş akışınız için Kling oluşturma sayfasıyla başlayın; örneğin Metinden Videoya, Görüntüden Videoya, veya Motion Control.

Görev terminal duruma ulaşana kadar yoklayın

Yanıt biçimini normalleştirin, ardından döndürülen görev kimliğiyle sorgulamaya devam edin terminal duruma ulaşana kadar. Motion Control için terminal durumlar şunlardır: succeed ve failed.

İş akışındaki sonraki adıma geçin

Tamamlanan çıktıyı doğrudan kullanın veya iş akışınız zincirleme işlemleri destekliyorsa sonraki uygun işlem sayfasına geçin.

Yaygın yol çiftleri

İş akışı	Sorgu yolu
Metinden videoya	`/kling/v1/videos/text2video/{task_id}`
Görüntüden videoya	`/kling/v1/videos/image2video/{task_id}`
Motion Control	`/kling/v1/videos/motion-control/{task_id}`
Çoklu görüntü videosu	`/kling/v1/videos/multi-image2video/{task_id}`
Video efektleri	`/kling/v1/videos/effects/{task_id}`
Video uzatma	`/kling/v1/videos/video-extend/{task_id}`
Avatar videosu	`/kling/v1/videos/avatar/image2video/{task_id}`

Parametrelerin tam referansı için şu sayfaya bakın: resmî Kling dokümantasyonu.

Yetkilendirmeler

Authorization

string

header

gerekli

Bearer token authentication. Use your CometAPI key.

Yol Parametreleri

action

string

gerekli

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

action2

string

gerekli

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

gerekli

Task ID

Yanıt

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

gerekli

Kling task ID.

task_status

string

gerekli

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

Son değiştirilme tarihi 31 Temmuz 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
}

İçerik moderasyonu

API anahtarları

Önce kontrol edilecekler

Yoklama düzeni

Yaygın yol çiftleri

Yetkilendirmeler

Yol Parametreleri

Yanıt

​Önce kontrol edilecekler

​Yoklama düzeni

​Yaygın yol çiftleri

Yetkilendirmeler

Yol Parametreleri

Yanıt

Önce kontrol edilecekler

Yoklama düzeni

Yaygın yol çiftleri