Naar hoofdinhoud gaan
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
  }
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Gebruik dit endpoint wanneer je wilt dat Kling één afbeelding genereert op basis van meerdere onderwerpverwijzingen plus optionele scène- of stijlverwijzingen.

​
Voordat je het aanroept

  • Lever 2 tot 4 afbeeldingen aan in subject_image_list
  • Gebruik model_name: kling-v2
  • Voeg scence_image of style_image alleen toe wanneer de kerncompositie van het onderwerp al goed werkt
  • Behandel dit als een asynchrone generatieroute en sla de geretourneerde task id op

​
Taakverloop

1

Dien de afbeelding-generatietaak in

Verstuur de lijst met onderwerpafbeeldingen en de prompt, en sla vervolgens de geretourneerde task id op.
2

Poll de taak

Ga verder met Individual Queries via het Kling-pad voor afbeeldingsquery’s totdat de taak een eindstatus bereikt.
3

Sla het resultaat op

Sla de gegenereerde afbeelding op in je eigen opslag als je duurzame toegang nodig hebt.
Zie voor de volledige parameterreferentie de officiële Kling-documentatie.

Autorisaties

​
Authorization
string
header
vereist

Bearer token authentication. Use your CometAPI key.

Headers

​
Content-Type
string

Content type of the request body.

Body

application/json

Kling Image Generation API request body definition

​
subject_image_list
object[]
vereist

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

​
model_name
enum<string>
standaard:kling-v2

Model to use for multi-image generation.

Beschikbare opties:
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
standaard:1

Number of images to generate.

​
aspect_ratio
enum<string>
standaard:16:9

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

Beschikbare opties:
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.

Respons

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