Skip to main content
POST
cURL
Utilisez ce endpoint lorsque vous souhaitez que Kling génère une image à partir de plusieurs références de sujet, avec éventuellement des références de scène ou de style.

Avant de l’appeler

  • Fournissez 1 à 4 images dans subject_image_list
  • Utilisez model_name: kling-v2-1 pour les nouvelles requêtes
  • Ajoutez scene_image ou style_image uniquement lorsque la composition du sujet principal fonctionne déjà
  • Traitez cela comme une route de génération asynchrone et enregistrez l’id de tâche renvoyé

Flux de tâche

1

Soumettre la tâche de génération d'image

Envoyez la liste d’images du sujet et le prompt, puis stockez l’id de tâche renvoyé.
2

Interroger la tâche

Interrogez la tâche renvoyée avec le chemin de requête d’image Kling correspondant jusqu’à ce que la tâche atteigne un état terminal.
3

Conserver le résultat

Enregistrez l’image générée dans votre propre stockage si vous avez besoin d’un accès durable.
Pour la référence complète des paramètres, consultez la documentation officielle de Kling.

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
subject_image_list
object[]
requis

Subject reference images. Minimum 1, maximum 4.

Required array length: 1 - 4 elements
model_name
enum<string>
défaut:kling-v2

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

Options disponibles:
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
défaut:1

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

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

Aspect ratio of the generated image.

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 for task status notifications.

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.