Çoklu Görselden Videoya

CometAPI POST /kling/v1/videos/multi-image2video üzerinden, hareket kontrolü ve üretim için çıktı ayarlarıyla birden fazla görselden Kling videoları oluşturun.

POST /kling/v1/videos/multi-image2video

Create a Kling multi-image-to-video task

cURL

curl --request POST \
  --url https://api.cometapi.com/kling/v1/videos/multi-image2video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model_name": "kling-v1-6",
  "duration": "5",
  "image_list": [
    {
      "image": "https://h2.inkwai.com/bs2/upload-ylab-stunt/se/ai_portal_queue_mmu_image_upscale_aiweb/3214b798-e1b4-4b00-b7af-72b5b0417420_raw_image_0.jpg"
    },
    {
      "image": "https://h2.inkwai.com/bs2/upload-ylab-stunt/se/ai_portal_queue_mmu_image_upscale_aiweb/3214b798-e1b4-4b00-b7af-72b5b0417420_raw_image_0.jpg"
    },
    {
      "image": "https://filesystem.site/cdn/20250414/chxiLc2O45zoLT8BCrQ6WQlTvGDDnK.png"
    },
    {
      "image": "https://filesystem.site/cdn/20250414/chxiLc2O45zoLT8BCrQ6WQlTvGDDnK.png"
    }
  ],
  "prompt": "The astronauts got up and left."
}
'

200

{
  "code": 0,
  "message": "SUCCEED",
  "data": {
    "task_id": "861309198188019719",
    "task_status": "submitted",
    "task_info": {},
    "created_at": 1773380633979,
    "updated_at": 1773380633979
  }
}

Kaynak olarak tek bir görsel yeterli olmadığında ve Kling’in hareketi birden fazla görsel referansından oluşturmasını istediğinizde bu endpoint’i kullanın.

​

Çağırmadan önce

• image_list içinde 2 ila 4 görsel hazırlayın
• model_name: kling-v1-6 ile veya doğruladığınız başka bir güncel modelle başlayın
• İlk testi basit tutun: kısa bir prompt, hareket maskesi yok, ek callback ayarı yok

​

Görev akışı

1. Çoklu görsel isteğini gönderin

   Görsel listesini, prompt’u ve süreyi gönderin, ardından dönen Kling task_id değerini kaydedin.

2. Görevi sorgulayın

   Görev son duruma ulaşana kadar Bireysel Sorgular ile devam edin.

3. Sonucu kalıcı olarak saklayın

   Sağlayıcının teslim URL’sinin ötesinde saklama süresine ihtiyacınız varsa tamamlanan videoyu depolayın.

Tam parametre referansı için resmi Kling dokümantasyonuna bakın.

Yetkilendirmeler

Authorization · string · header · gerekli

Bearer token authentication. Use your CometAPI key.

Gövde

application/json

model_name · string · varsayılan: kling-v1-6 · gerekli

Kling model variant to use. See the Models page for current options.

duration · string · varsayılan: 5 · gerekli

Output video length in seconds. Options: 5, 10.

image_list · object[] · gerekli

2 to 4 source images. Each item provides an image field as a public URL or Base64 string (without data: prefix). Accepted formats: JPG, JPEG, PNG. Maximum 10 MB per image, minimum 300×300 px, aspect ratio between 1:2.5 and 2.5:1.

Show child attributes

prompt · string · varsayılan: The cat turns its head and blinks. · gerekli

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 · string

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

cfg_scale · number

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

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

Dynamic brush configuration. Up to 6 groups, each containing a painted-area mask and a motion trajectory.

Show child attributes

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.

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

Show child attributes