Skip to main content
POST
cURL

Génération d’images

Pour la référence complète des paramètres, consultez la documentation officielle de Kling.
Utilisez ce endpoint pour créer des images fixes via l’API de génération d’images de Kling. Il prend en charge les requêtes text-only et les requêtes avec images de référence via le même flux de tâches asynchrone.

Première requête

Commencez avec model_name: kling-v3, prompt, n et aspect_ratio. Ajoutez des images de référence, des contrôles de fidélité ou des champs avancés seulement après que la première requête a renvoyé une tâche exploitable. Omettre model_name utilise une valeur par défaut de compatibilité héritée ; envoyez donc explicitement kling-v3 pour les nouvelles intégrations.

Lire la réponse

Enregistrez le task_id renvoyé, puis interrogez la route de requête d’image Kling correspondante jusqu’à ce que task_status atteigne un état terminal. Si votre flux de travail nécessite un stockage durable, copiez l’asset final dans votre propre couche de stockage une fois la génération terminée.

Autorisations

Authorization
string
header
requis

Bearer token authentication. Use your CometAPI key.

En-têtes

Content-Type
string
défaut:application/json

Must be application/json.

Corps

application/json
prompt
string
requis

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

model_name
enum<string>
défaut:kling-v1

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

Options disponibles:
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.

Options disponibles:
subject,
face
image_fidelity
number
défaut:0.5

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

Plage requise: 0 <= x <= 1
human_fidelity
number
défaut:0.45

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

Plage requise: 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>
défaut:1k

Output resolution. Defaults to 1k.

Options disponibles:
1k,
2k
n
integer
défaut:1

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

Plage requise: 1 <= x <= 9
aspect_ratio
enum<string>
défaut:16:9

Output aspect ratio (width:height).

Options disponibles:
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.

Réponse

200 - application/json

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

code
requis

Response code. 0 means the task request was accepted.

message
string
requis

Response message.

data
object
requis
request_id
string

Request identifier returned when present.