Skip to main content
POST
cURL

Bildegenerering

For fullstendig referanse for parametere, se den offisielle Kling-dokumentasjonen.
Bruk dette endepunktet til å opprette stillbilder gjennom Klings API for bildegenerering. Det støtter både forespørsler med kun tekst og forespørsler med bildereferanser gjennom samme asynkrone oppgaveflyt.

Første forespørsel

Start med model_name: kling-v3, prompt, n og aspect_ratio. Legg til referansebilder, fidelitetskontroller eller avanserte felt først etter at den første forespørselen returnerer en brukbar oppgave. Hvis model_name utelates, brukes en eldre standardverdi for kompatibilitet, så send kling-v3 eksplisitt for nye integrasjoner.

Les svaret

Lagre den returnerte task_id, og poll deretter den tilsvarende Kling-ruten for bildeforespørsler til task_status når en terminal tilstand. Hvis arbeidsflyten din trenger varig lagring, kopier det endelige objektet til ditt eget lagringslag etter at genereringen er fullført.

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
prompt
string
påkrevd

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

model_name
enum<string>
standard:kling-v1

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

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

Tilgjengelige alternativer:
subject,
face
image_fidelity
number
standard:0.5

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

Nødvendig område: 0 <= x <= 1
human_fidelity
number
standard:0.45

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

Nødvendig område: 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>
standard:1k

Output resolution. Defaults to 1k.

Tilgjengelige alternativer:
1k,
2k
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

Output aspect ratio (width:height).

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 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.

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