Skip to main content
POST
cURL
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 1 tot 4 afbeeldingen aan in subject_image_list
  • Gebruik model_name: kling-v2-1 voor nieuwe verzoeken
  • Voeg scene_image of style_image alleen toe wanneer de kerncompositie van het onderwerp al goed werkt
  • Behandel dit als een async-generatieroute en sla de geretourneerde task id op

Task flow

1

Dien de taak voor het genereren van afbeeldingen in

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

Poll de taak

Poll de geretourneerde taak met het overeenkomende Kling-querypad voor afbeeldingen 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
standaard:application/json

Must be application/json.

Body

application/json
subject_image_list
object[]
vereist

Subject reference images. Minimum 1, maximum 4.

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

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

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

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

Vereist bereik: 1 <= x <= 9
aspect_ratio
enum<string>
standaard:16:9

Aspect ratio of the generated image.

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

Respons

200 - application/json

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

code
vereist

Response code. 0 means the task request was accepted.

message
string
vereist

Response message.

data
object
vereist
request_id
string

Request identifier returned when present.