Skip to main content
POST
cURL
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 1 a 4 immagini in image_list
  • Usa immagini che soddisfano i requisiti in pixel di Kling; le miniature molto piccole vengono rifiutate dal task di generazione
  • Ometti model_name a meno che tu non debba specificamente selezionare un modello compatibile con la route
  • Mantieni semplice il primo test: un prompt breve, duration: 5, nessuna impostazione di callback aggiuntiva
  • Non inviare campi mask per image-to-video come static_mask o dynamic_masks su questa route

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

Continua con Get a Kling task finché il task non raggiunge uno stato terminale.
3

Salva il risultato

Archivia il video completato se ti serve conservarlo oltre l’URL di consegna del provider.
Per il riferimento completo dei parametri, vedi la documentazione ufficiale di Kling.

Autorizzazioni

Authorization
string
header
obbligatorio

Bearer token authentication. Use your CometAPI key.

Corpo

application/json
image_list
object[]
obbligatorio

Input image references. Provide 1 to 4 items that meet Kling pixel requirements; very small thumbnails are rejected.

Required array length: 1 - 4 elements
model_name
enum<string>
predefinito:kling-v1-6

Kling model variant for multi-image video. Omit to use kling-v1-6.

Opzioni disponibili:
kling-v1-6
prompt
string

Text prompt describing the desired motion and scene.

negative_prompt
string

Elements to avoid in the generated video.

mode
enum<string>
predefinito:std

Generation mode. Use std or pro; omitted requests use std.

Opzioni disponibili:
std,
pro
duration
string
predefinito:5

Output video length in seconds. Use 5 or 10; omitted requests use 5.

aspect_ratio
enum<string>

Requested frame aspect ratio when the model needs an explicit frame shape.

Opzioni disponibili:
16:9,
9:16,
1:1
callback_url
string

Webhook URL to receive task status updates.

external_task_id
string

Custom task id for your own tracking. Must be unique per account.

Risposta

200 - application/json

Task accepted.

code
integer
obbligatorio

Error code; specifically define the error code

message
string
obbligatorio

error message

data
object
obbligatorio