Skip to main content
POST
cURL
Bruk dette endepunktet når du vil at Kling skal generere ett bilde fra flere motivreferanser, samt valgfrie scene- eller stilreferanser.

Før du kaller det

  • Oppgi 1 til 4 bilder i subject_image_list
  • Bruk model_name: kling-v2-1 for nye forespørsler
  • Legg til scene_image eller style_image bare når den grunnleggende motivkomposisjonen allerede fungerer
  • Behandle dette som en asynkron genereringsrute og lagre den returnerte task id-en

Oppgaveflyt

1

Send inn bildegenereringsoppgaven

Send motivbildelisten og prompt, og lagre deretter den returnerte task id-en.
2

Poll oppgaven

Poll den returnerte oppgaven med den tilsvarende Kling-bildespørringsstien til oppgaven når en terminaltilstand.
3

Lagre resultatet

Lagre det genererte bildet i din egen lagring hvis du trenger varig tilgang.
For den fullstendige parameterreferansen, se den offisielle Kling-dokumentasjonen.

Autorisasjoner

Authorization
string
header
påkrevd

Bearer token authentication. Use your CometAPI key.

Overskrifter

Content-Type
string
standard:application/json

Must be application/json.

Kropp

application/json
subject_image_list
object[]
påkrevd

Subject reference images. Minimum 1, maximum 4.

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

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

Tilgjengelige alternativer:
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
standard:1

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

Nødvendig område: 1 <= x <= 9
aspect_ratio
enum<string>
standard:16:9

Aspect ratio of the generated image.

Tilgjengelige alternativer:
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.

Svar

200 - application/json

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

code
påkrevd

Response code. 0 means the task request was accepted.

message
string
påkrevd

Response message.

data
object
påkrevd
request_id
string

Request identifier returned when present.

Sist endret 26. juni 2026