Da più immagini a video

Crea video Kling a partire da più immagini tramite CometAPI POST /kling/v1/videos/multi-image2video, con controllo del movimento e impostazioni di output per la generazione.

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
  }
}

Usa questo endpoint quando una sola immagine sorgente non è sufficiente e vuoi che Kling costruisca il movimento a partire da più immagini di riferimento.

​

Prima di chiamarlo

• Prepara da 2 a 4 immagini in image_list
• Inizia con model_name: kling-v1-6 o un altro modello attuale che hai già verificato
• Mantieni semplice il primo test: un prompt breve, nessuna motion mask, nessuna impostazione di callback aggiuntiva

​

Flusso del task

1. Invia la richiesta multi-image

   Invia l’elenco di immagini, il prompt e la durata, quindi salva il task_id di Kling restituito.

2. Interroga il task

   Prosegui con Individual Queries finché il task non raggiunge uno stato terminale.

3. Salva il risultato

   Salva il video completato se hai bisogno di conservarlo oltre l’URL di consegna del provider.

Per il riferimento completo dei parametri, consulta la documentazione ufficiale di Kling.

Autorizzazioni

Authorization · string · header · obbligatorio

Bearer token authentication. Use your CometAPI key.

Corpo

application/json

model_name · string · predefinito: kling-v1-6 · obbligatorio

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

duration · string · predefinito: 5 · obbligatorio

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

image_list · object[] · obbligatorio

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 · predefinito: The cat turns its head and blinks. · obbligatorio

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.

Risposta

200 - application/json

Task accepted.

code · integer · obbligatorio

Error code; specifically define the error code

message · string · obbligatorio

error message

data · object · obbligatorio

Show child attributes