Skip to main content
POST
cURL
Verwenden Sie diesen Endpunkt, wenn Sie möchten, dass Kling aus mehreren Motiv-Referenzen sowie optionalen Szenen- oder Stil-Referenzen ein Bild generiert.

Bevor Sie ihn aufrufen

  • Stellen Sie 1 bis 4 Bilder in subject_image_list bereit
  • Verwenden Sie model_name: kling-v2-1 für neue Anfragen
  • Fügen Sie scene_image oder style_image nur hinzu, wenn die grundlegende Motivkomposition bereits funktioniert
  • Behandeln Sie dies als asynchrone Generierungsroute und speichern Sie die zurückgegebene task id

Aufgabenablauf

1

Die Bildgenerierungsaufgabe absenden

Senden Sie die Liste der Motivbilder und den Prompt und speichern Sie dann die zurückgegebene task id.
2

Die Aufgabe abfragen

Fragen Sie die zurückgegebene Aufgabe mit dem passenden Kling-Bild-Abfragepfad ab, bis die Aufgabe einen Endzustand erreicht.
3

Das Ergebnis speichern

Speichern Sie das generierte Bild in Ihrem eigenen Speicher, wenn Sie dauerhaften Zugriff benötigen.
Die vollständige Parameterreferenz finden Sie in der offiziellen Kling-Dokumentation.

Autorisierungen

Authorization
string
header
erforderlich

Bearer token authentication. Use your CometAPI key.

Header

Content-Type
string
Standard:application/json

Must be application/json.

Body

application/json
subject_image_list
object[]
erforderlich

Subject reference images. Minimum 1, maximum 4.

Required array length: 1 - 4 elements
model_name
enum<string>
Standard:kling-v2

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

Verfügbare Optionen:
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
Standard:1

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

Erforderlicher Bereich: 1 <= x <= 9
aspect_ratio
enum<string>
Standard:16:9

Aspect ratio of the generated image.

Verfügbare Optionen:
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.

Antwort

200 - application/json

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

code
erforderlich

Response code. 0 means the task request was accepted.

message
string
erforderlich

Response message.

data
object
erforderlich
request_id
string

Request identifier returned when present.