Vai al contenuto principale
POST
/
kling
/
v1
/
images
/
generations
Multi-Image to Image
curl --request POST \
  --url https://api.cometapi.com/kling/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "subject_image_list": [
    {
      "subject_image": "https://filesystem.site/cdn/20250814/goDW44JIf6eSuxAS7TNringhWjO9kW.png"
    },
    {
      "subject_image": "https://filesystem.site/cdn/20250814/goDW44JIf6eSuxAS7TNringhWjO9kW.png"
    },
    {
      "subject_image": "https://filesystem.site/cdn/20250814/goDW44JIf6eSuxAS7TNringhWjO9kW.png"
    },
    {
      "subject_image": "https://filesystem.site/cdn/20250814/goDW44JIf6eSuxAS7TNringhWjO9kW.png"
    }
  ]
}
'
{
  "code": 123,
  "message": "<string>",
  "request_id": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "<string>",
    "created_at": 123,
    "updated_at": 123
  }
}
Usa questo endpoint quando vuoi che Kling generi un’immagine a partire da più riferimenti del soggetto, più riferimenti opzionali per scena o stile.

Prima di chiamarlo

  • Fornisci da 2 a 4 immagini in subject_image_list
  • Usa model_name: kling-v2
  • Aggiungi scence_image o style_image solo quando la composizione principale del soggetto funziona già
  • Considera 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

Esegui il polling del task

Continua con Query individuali usando il percorso di query delle immagini Kling finché il task non raggiunge uno stato terminale.
3

Salva il risultato

Salva l’immagine generata nel tuo sistema di storage 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

Content type of the request body.

Corpo

application/json

Kling Image Generation API request body definition

subject_image_list
object[]
obbligatorio

List of subject reference images. Minimum 2, maximum 4.

model_name
enum<string>
predefinito:kling-v2

Model to use for multi-image generation.

Opzioni disponibili:
kling-v2
prompt
string

Text prompt describing the desired output. Max 2500 characters.

scence_image
string

Optional scene reference image. Same format and size constraints as subject images.

style_image
string

Optional style reference image. Same format and size constraints as subject images.

n
integer
predefinito:1

Number of images to generate.

aspect_ratio
enum<string>
predefinito:16:9

Aspect ratio of the generated image (width:height).

Opzioni disponibili:
16:9,
9:16,
1:1,
4:3,
3:4,
3:2,
2:3,
21:9
callback_url
string

Webhook URL for task status notifications. The server sends a callback when the task status changes.

external_task_id
string

Optional user-defined task ID for your own tracking. Does not replace the system-generated task ID. Must be unique per account.

Risposta

200 - application/json

Successful Response

code
integer

Error code; specifically define the error code

message
string

error message

request_id
string

Request ID, system-generated, for tracking requests, troubleshooting issues

data
object