Bir Kling Omni videosu oluşturma

POST

kling

videos

omni-video

curl https://api.cometapi.com/kling/v1/videos/omni-video \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "model_name": "kling-v3-omni",
      "prompt": "A paper boat drifts across a calm pond at sunrise.",
      "mode": "std",
      "aspect_ratio": "16:9",
      "duration": "5",
      "sound": "off"
    }'

{
  "code": 0,
  "message": "SUCCEED",
  "data": {
    "task_id": "<task_id>",
    "task_status": "submitted",
    "task_info": {
      "external_task_id": null
    },
    "task_status_msg": null,
    "created_at": 1773366840306,
    "updated_at": 1773366840306
  }
}

Bu endpoint’i, metinden videoya ve ilk kare görsel referanslı üretim dahil olmak üzere, CometAPI tarafından sunulan O1 uyumlu Kling Omni iş akışı için kullanın.

Sağlayıcı parametrelerinin tam referansı için Kling Omni Video belgelerine bakın.

Girdi modunu seçin

Metinden videoya: prompt, mode, aspect_ratio ve duration gönderin
İlk kare görsel referansı: image_url ve type: first_frame içeren image_list öğeleri ekleyin, ardından görsele prompt içinde <<<image_1>>> olarak referans verin
Filigranlı çıktı: sorgu yanıtında filigranlı bir video URL’sine ihtiyacınız olduğunda watermark_info.enabled: true ekleyin
Model ID: rota varsayılanını kullanmak için model_name alanını atlayın veya kling-video-o1 ya da kling-v3-omni gibi test edilmiş bir Omni Video model ID gönderin

Süre ve en-boy oranı

Ayar	Desteklenen değerler	Varsayılan	Sınır davranışı
Metin veya ilk kare videosu için `duration`	`"5"`, `"10"`	`"5"`	Değeri string olarak gönderin ve iki sabit üretim uzunluğundan birini kullanın.
`aspect_ratio`	`16:9`, `9:16`, `1:1`	`16:9`	Kareyi kontrol eden bir ilk kare görseli yoksa gereklidir.
`mode`	`std`, `pro`	rota varsayılanı	Standart üretim için `std` gönderin; `pro` değerini yalnızca seçtiğiniz model daha yüksek kaliteli modu destekliyorsa kullanın.

Kling Omni tam bir size alanı sunmaz. aspect_ratio değerini bir kare biçimi isteği olarak değerlendirin; 16:9 metinden videoya isteği full-HD 1920x1080 olarak oluşturulabilir.

Görev akışı

Omni görevini oluşturun

İsteği gönderin ve döndürülen task_id değerini saklayın.

Omni görevini sorgulayın

Görev tamamlanana kadar Bir Kling Omni videosu alın ile devam edin.

Tamamlanan videoyu kalıcı olarak saklayın

Kalıcı erişime ihtiyacınız varsa döndürülen MP4 URL’sini kendi depolamanıza taşıyın.

Yetkilendirmeler

Authorization

string

header

gerekli

Bearer token authentication. Use your CometAPI key.

Başlıklar

Content-Type

string

Content type of the request body.

Gövde

application/json

prompt

string

gerekli

Text prompt describing the desired video. Maximum length is 2,500 characters. When you send image_list, reference the image with <<<image_1>>>.

model_name

string

Optional model ID for this Kling Omni video request. Omit this field to use the route default.

image_list

object[]

Optional first-frame image reference for image-referenced Omni generation.

Show child attributes

sound

enum<string>

varsayılan:off

Whether to generate audio with the video. Use on or off.

Mevcut seçenekler:

on,

off

mode

enum<string>

Generation mode. Use std for standard generation or pro when the selected model supports the higher-quality mode.

Mevcut seçenekler:

std,

pro

aspect_ratio

enum<string>

Aspect ratio request for beta Kling Omni generation. The endpoint does not expose an exact size field; a 16:9 text-to-video request can render as 1920x1080.

Mevcut seçenekler:

16:9,

9:16,

1:1

duration

enum<string>

varsayılan:5

Requested output length for text-to-video and first-frame image-reference workflows. Use 5 or 10 as a string.

Mevcut seçenekler:

5,

10

watermark_info

object

Watermark options. When enabled is true, the task can return watermarked result URLs in addition to original result URLs.

Show child attributes

callback_url

string<uri>

Webhook URL for task status notifications. The server sends a callback when the task status changes.

external_task_id

string

Optional user-defined task ID for your own tracking. Does not replace the system-generated task ID. Must be unique per account.

Yanıt

200 - application/json

Success

code

integer

gerekli

Response code. 0 means the task request was accepted.

message

string

gerekli

Response message.

data

object

gerekli

Show child attributes

request_id

string

Request identifier returned by CometAPI when present.

Bir Kling görevi al

Bir Kling Omni videosu alın

curl https://api.cometapi.com/kling/v1/videos/omni-video \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "model_name": "kling-v3-omni",
      "prompt": "A paper boat drifts across a calm pond at sunrise.",
      "mode": "std",
      "aspect_ratio": "16:9",
      "duration": "5",
      "sound": "off"
    }'

{
  "code": 0,
  "message": "SUCCEED",
  "data": {
    "task_id": "<task_id>",
    "task_status": "submitted",
    "task_info": {
      "external_task_id": null
    },
    "task_status_msg": null,
    "created_at": 1773366840306,
    "updated_at": 1773366840306
  }
}

İçerik moderasyonu

API anahtarları

Girdi modunu seçin

Süre ve en-boy oranı

Görev akışı

Yetkilendirmeler

Başlıklar

Gövde

Yanıt

​Girdi modunu seçin

​Süre ve en-boy oranı

​Görev akışı

Yetkilendirmeler

Başlıklar

Gövde

Yanıt

Girdi modunu seçin

Süre ve en-boy oranı

Görev akışı