Skip to main content
POST
cURL

Generazione di immagini

Per il riferimento completo dei parametri, consulta la documentazione ufficiale di Kling.
Usa questo endpoint per creare immagini statiche tramite l’API di generazione di immagini di Kling. Supporta richieste solo testuali e richieste con immagini di riferimento attraverso lo stesso flusso di task asincrono.

Prima richiesta

Inizia con model_name: kling-v3, prompt, n e aspect_ratio. Aggiungi immagini di riferimento, controlli di fedeltà o campi avanzati solo dopo che la prima richiesta restituisce un task utilizzabile. Omettere model_name usa un valore predefinito legacy per la compatibilità, quindi invia esplicitamente kling-v3 per le nuove integrazioni.

Leggere la risposta

Salva il task_id restituito, quindi interroga la route di query immagini Kling corrispondente finché task_status non raggiunge uno stato terminale. Se il tuo flusso di lavoro richiede uno storage persistente, copia l’asset finale nel tuo livello di storage dopo il completamento della generazione.

Autorizzazioni

Authorization
string
header
obbligatorio

Bearer token authentication. Use your CometAPI key.

Intestazioni

Content-Type
string
predefinito:application/json

Must be application/json.

Corpo

application/json
prompt
string
obbligatorio

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

model_name
enum<string>
predefinito:kling-v1

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

Opzioni disponibili:
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.

Opzioni disponibili:
subject,
face
image_fidelity
number
predefinito:0.5

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

Intervallo richiesto: 0 <= x <= 1
human_fidelity
number
predefinito:0.45

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

Intervallo richiesto: 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>
predefinito:1k

Output resolution. Defaults to 1k.

Opzioni disponibili:
1k,
2k
n
integer
predefinito:1

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

Intervallo richiesto: 1 <= x <= 9
aspect_ratio
enum<string>
predefinito:16:9

Output aspect ratio (width:height).

Opzioni disponibili:
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.

Risposta

200 - application/json

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

code
obbligatorio

Response code. 0 means the task request was accepted.

message
string
obbligatorio

Response message.

data
object
obbligatorio
request_id
string

Request identifier returned when present.