Skip to main content
POST
cURL
Bu endpoint’i kullanarak bir kaynak görseli bir Kling videosuna canlandırabilirsiniz.

Çağırmadan önce

  • Bir adet herkese açık görsel URL’si veya bir adet base64 görsel dizesi sağlayın
  • Kling piksel gereksinimlerini karşılayan bir görsel kullanın; çok küçük küçük resimler generation görevi tarafından reddedilir
  • Varsayılan kling-v2-6 örneğiyle başlayın, ardından farklı bir model hattına ihtiyaç duyduğunuzda OpenAPI enum içinden başka bir model_name seçin
  • İlk isteği basit tutun: bir giriş görseli, bir prompt, kuyruk karesi yok, hareket maskeleri yok
  • Kontrollü yerel hareket gerektiğinde dynamic_masks öğesini maske ve yörünge nesnelerinden oluşan bir dizi olarak kullanın
  • Üretilen sesi destekleyen model hatlarında, ses içermeyen deterministik bir ilk istek için sound: off kullanın

Model adlandırma

Bu endpoint’te standart Kling video model ID’lerini kullanın. Omni model ID’lerini Omni Video için saklayın.

Görev akışı

1

image-to-video isteğini gönderin

Görevi oluşturun ve döndürülen Kling task_id değerini saklayın.
2

Görevi sorgulayın

Çıktı hazır olana kadar görev durumunu takip etmek için Bir Kling görevini alın ile devam edin.
3

Sonucu saklayın

Sağlayıcının teslim URL’sinin ötesinde saklama süresine ihtiyacınız varsa tamamlanan varlığı kalıcı olarak kaydedin.
Tam parametre referansı için resmî Kling belgesine bakın.

Yetkilendirmeler

Authorization
string
header
gerekli

Bearer token authentication. Use your CometAPI key.

Gövde

application/json
image
string
gerekli

Source image URL or base64 image string. Use an image that meets Kling pixel requirements; very small thumbnails are rejected. For base64 input, send the encoded image string as the field value.

prompt
string

Text prompt describing the desired motion. Maximum 500 characters.

negative_prompt
string

Elements to exclude from the video. Maximum 200 characters.

callback_url
string

Webhook URL to receive task status updates when the task completes.

mode
enum<string>
varsayılan:std

Generation mode. std for standard (faster), pro for professional (higher quality).

Mevcut seçenekler:
std,
pro
model_name
enum<string>
varsayılan:kling-v1

Model ID for this image-to-video request. Use kling-v3 for new requests. Use Omni model IDs only with the Omni Video endpoint.

Mevcut seçenekler:
kling-v1,
kling-v1-5,
kling-v1-6,
kling-v2-master,
kling-v2-1,
kling-v2-1-master,
kling-v2-5-turbo,
kling-v2-6,
kling-v3
image_tail
string

Tail-frame reference image as a Base64 string or public URL. Same format requirements as image. Controls the last frame of the generated video.

cfg_scale
number

Prompt adherence strength. Higher values follow the prompt more closely. Range: 0–1.

duration
string
varsayılan:5

Output video length in seconds. Use 5 or 10; omit to use 5.

static_mask
string

Static brush mask image as a Base64 string or public URL. White areas are frozen in place during video generation. Must match the aspect ratio and resolution of the input image.

dynamic_masks
object[]

Optional motion masks. Each entry contains a mask image and an ordered trajectory list.

external_task_id
string

Custom task id for your own tracking. Does not replace the system-generated task id but can be used to query tasks. Must be unique per user.

sound
enum<string>

Optional generated-audio switch for models that support video sound. Use on or off, or omit the field for the model default.

Mevcut seçenekler:
on,
off

Yanıt

200 - application/json

Task accepted.

code
integer
gerekli

Error code; specifically define the error code

message
string
gerekli

error message

data
object
gerekli