Skip to main content
POST
cURL

Afbeeldingsgeneratie

Raadpleeg voor de volledige parameterreferentie de officiële Kling-documentatie.
Gebruik dit endpoint om stilstaande afbeeldingen te maken via Kling’s API voor afbeeldingsgeneratie. Het ondersteunt zowel alleen-tekstverzoeken als verzoeken met beeldreferenties via dezelfde asynchrone taakstroom.

Eerste verzoek

Begin met model_name: kling-v3, prompt, n en aspect_ratio. Voeg pas beeldreferenties, fidelity-instellingen of geavanceerde velden toe nadat het eerste verzoek een bruikbare taak heeft opgeleverd. Als model_name wordt weggelaten, wordt een verouderde compatibiliteitsstandaard gebruikt, dus stuur kling-v3 expliciet mee voor nieuwe integraties.

Lees de response

Sla de geretourneerde task_id op en poll vervolgens de overeenkomende Kling-route voor afbeeldingsquery’s totdat task_status een eindstatus bereikt. Als je workflow duurzame opslag nodig heeft, kopieer dan het definitieve asset naar je eigen opslaglaag nadat de generatie is voltooid.

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
prompt
string
vereist

Text prompt describing the image to generate. Maximum 2500 characters.

model_name
enum<string>
standaard:kling-v1

Kling image model variant. Use kling-v3 for new requests. Omitting model_name uses the legacy CometAPI route default.

Beschikbare opties:
kling-v1,
kling-v1-5,
kling-v2,
kling-v2-1,
kling-v3
negative_prompt
string

Elements to exclude from the image. Maximum 2500 characters. Not supported when image is provided.

image
string

Reference image as a raw Base64 string without a data: prefix, or a public URL. Accepted formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300x300 px, aspect ratio between 1:2.5 and 2.5:1.

image_reference
enum<string>

Reference mode for legacy image-to-image requests when image is provided.

Beschikbare opties:
subject,
face
image_fidelity
number
standaard:0.5

How closely the output follows the reference image. Range: 0-1. Used by legacy image-reference models.

Vereist bereik: 0 <= x <= 1
human_fidelity
number
standaard:0.45

Human-subject fidelity control. Range: 0-1. Used only by legacy subject-reference requests.

Vereist bereik: 0 <= x <= 1
element_list
object[]

Optional Kling element references. The total count of element references and input images must not exceed 10.

resolution
enum<string>
standaard:1k

Output resolution. Defaults to 1k.

Beschikbare opties:
1k,
2k
n
integer
standaard:1

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

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

Output aspect ratio (width:height).

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 to receive task status updates when the task completes.

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.