Skip to main content
POST
cURL
Verwenden Sie diesen Endpunkt, um über CometAPI eine asynchrone Kling Omni Image-Aufgabe zu erstellen. Die Erstellungsanfrage gibt eine task_id zurück; verwenden Sie Eine Kling Omni-Bildaufgabe abrufen, um die Aufgabe abzufragen, bis die URLs der generierten Bilder verfügbar sind.
Eine vollständige Referenz der Anbieterparameter finden Sie in der Kling Image O1-Dokumentation.

Wählen Sie die Anfragestruktur

  • Generierung eines einzelnen Bildes: Senden Sie prompt, image_list, resolution, result_type: single, n und aspect_ratio
  • Ausgabe mit Wasserzeichen: Fügen Sie watermark_info.enabled: true hinzu, wenn Sie eine Ergebnis-URL mit Wasserzeichen in der Abfrageantwort benötigen
  • Model ID: Lassen Sie model_name weg, um den Standardwert der Route zu verwenden, oder senden Sie eine getestete Omni Image-Model ID wie kling-image-o1 oder kling-v3-omni
Referenzbilder verwenden image_list-Elemente mit einem image-Feld. Der Prompt kann sie per Index referenzieren, z. B. <<<image_1>>> für das erste Element und <<<image_2>>> für das zweite Element.

Aufgabenablauf

1

Aufgabe erstellen

Senden Sie POST /kling/v1/images/omni-image und speichern Sie die zurückgegebene data.task_id.
2

Aufgabe abfragen

Fragen Sie GET /kling/v1/images/omni-image/ ab, bis data.task_status den Wert succeed oder failed hat.
3

Bilder speichern

Wenn die Aufgabe erfolgreich abgeschlossen ist, kopieren Sie data.task_result.images[].url in Ihren eigenen Speicher, wenn Sie dauerhaften Zugriff benötigen.
Das vollständige Antwortschema und Beispiele für das Polling finden Sie unter Eine Kling Omni-Bildaufgabe abrufen. Das folgende kurze Beispiel fragt eine Aufgabe ab, bis sie einen Endzustand erreicht:

Ergebnisfelder

Erfolgreiche Abfrageantworten geben generierte Bilder unter data.task_result.images zurück. Jedes Element kann Folgendes enthalten: URLs generierter Assets können ablaufen oder vom Anbieterdienst gelöscht werden. Speichern Sie die fertigen Bilder in Ihrer eigenen Speicherschicht, wenn Ihr Workflow eine lange Aufbewahrung benötigt.

Autorisierungen

Authorization
string
header
erforderlich

Bearer token authentication. Use your CometAPI API key.

Header

Content-Type
string

Must be application/json.

Body

application/json
prompt
string
erforderlich

Text prompt for the generated image. The prompt can reference images with <<<image_1>>>, <<<image_2>>>, and matching indexes from image_list. Maximum length is 2,500 characters.

model_name
string

Optional model ID for this Omni Image request. Omit this field to use the route default.

image_list
object[]

Reference images that the prompt can cite with <<<image_1>>>, <<<image_2>>>, and so on. Keep the total number of reference images within the provider limits for the selected model.

resolution
enum<string>
Standard:1k

Requested output resolution. Use 1k, 2k, or 4k; omitted requests use 1k.

Verfügbare Optionen:
1k,
2k,
4k
result_type
enum<string>
Standard:single

Use single for a single-image task.

Verfügbare Optionen:
single
n
integer
Standard:1

Number of single-image results to generate. Range: 1 to 9.

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

Requested output aspect ratio in width:height format. Use auto to let the provider choose from the prompt and references.

Verfügbare Optionen:
16:9,
9:16,
1:1,
4:3,
3:4,
3:2,
2:3,
21:9,
auto
watermark_info
object

Watermark options. When enabled is true, the task can return watermarked result URLs in addition to the original result URLs.

callback_url
string<uri>

Webhook URL that receives task status notifications when the task status changes. Omit this field to poll manually.

external_task_id
string

User-defined task ID for your own tracking. It does not replace the system-generated task_id and must be unique per account.

Antwort

200 - application/json

Task accepted.

code
integer
erforderlich

Response code. 0 means the task request was accepted.

message
string
erforderlich

Response message.

data
object
erforderlich
request_id
string

Request identifier returned by CometAPI when present.