Skip to main content
POST
cURL
Usa questo endpoint quando vuoi che Kling generi un’immagine a partire da più riferimenti di soggetto più riferimenti opzionali di scena o stile.

Prima di chiamarlo

  • Fornisci da 1 a 4 immagini in subject_image_list
  • Usa model_name: kling-v2-1 per le nuove richieste
  • Aggiungi scene_image o style_image solo quando la composizione del soggetto principale funziona già
  • Tratta questo come un percorso di generazione asincrona e salva il task id restituito

Flusso del task

1

Invia il task di generazione dell'immagine

Invia l’elenco delle immagini del soggetto e il prompt, quindi memorizza il task id restituito.
2

Interroga il task

Interroga il task restituito con il percorso di query dell’immagine Kling corrispondente finché il task non raggiunge uno stato terminale.
3

Salva il risultato

Salva l’immagine generata nel tuo sistema di archiviazione se ti serve un accesso persistente.
Per il riferimento completo dei parametri, consulta la documentazione ufficiale di Kling.

Autorizzazioni

Authorization
string
header
obbligatorio

Bearer token authentication. Use your CometAPI key.

Intestazioni

Content-Type
string
predefinito:application/json

Must be application/json.

Corpo

application/json
subject_image_list
object[]
obbligatorio

Subject reference images. Minimum 1, maximum 4.

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

Model to use for multi-image generation. Use kling-v2-1 for new requests; omitting the field uses the legacy route default.

Opzioni disponibili:
kling-v2,
kling-v2-1
prompt
string

Text prompt describing the desired output. Maximum 2500 characters.

negative_prompt
string

Elements to exclude from the image. Maximum 2500 characters.

scene_image
string

Optional scene reference image. Image URL or raw Base64 string without a data: prefix. Supported formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300x300 px, aspect ratio between 1:2.5 and 2.5:1.

style_image
string

Optional style reference image. Image URL or raw Base64 string without a data: prefix. Supported formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300x300 px, aspect ratio between 1:2.5 and 2.5:1.

n
integer
predefinito:1

Number of images to generate. Range: 1-9.

Intervallo richiesto: 1 <= x <= 9
aspect_ratio
enum<string>
predefinito:16:9

Aspect ratio of the generated image.

Opzioni disponibili:
16:9,
9:16,
1:1,
4:3,
3:4,
3:2,
2:3,
21:9
watermark_info
object

Watermark options.

callback_url
string

Webhook URL for task status notifications.

external_task_id
string

Optional user-defined task ID for your own tracking. Must be unique per account.

Risposta

200 - application/json

Task request accepted or an error response returned by the API.

code
obbligatorio

Response code. 0 means the task request was accepted.

message
string
obbligatorio

Response message.

data
object
obbligatorio
request_id
string

Request identifier returned when present.