Skip to main content
POST
cURL
Gebruik dit endpoint om via CometAPI een asynchrone Kling Omni Image-taak aan te maken. De aanmaakaanvraag retourneert een task_id; gebruik Een Kling Omni image-taak ophalen om de taak te pollen totdat de URL’s van de gegenereerde afbeeldingen beschikbaar zijn.
Zie voor de volledige providerparameterreferentie de Kling Image O1-documentatie.

Kies de request-vorm

  • Generatie van één afbeelding: stuur prompt, image_list, resolution, result_type: single, n en aspect_ratio
  • Output met watermerk: voeg watermark_info.enabled: true toe wanneer je een resultaat-URL met watermerk nodig hebt in de queryrespons
  • Model ID: laat model_name weg om de standaardinstelling van de route te gebruiken, of stuur een geteste Omni Image-model ID zoals kling-image-o1 of kling-v3-omni
Referentieafbeeldingen gebruiken image_list-items met een image-veld. De prompt kan ernaar verwijzen op index, zoals <<<image_1>>> voor het eerste item en <<<image_2>>> voor het tweede item.

Taakverloop

1

Maak de taak aan

Dien POST /kling/v1/images/omni-image in en sla de geretourneerde data.task_id op.
2

Vraag de taak op

Poll GET /kling/v1/images/omni-image/ totdat data.task_status succeed of failed is.
3

Sla de afbeeldingen op

Wanneer de taak slaagt, kopieer je data.task_result.images[].url naar je eigen opslag als je duurzame toegang nodig hebt.
Zie voor het volledige responseschema en pollingvoorbeelden Een Kling Omni image-taak ophalen. Het volgende korte voorbeeld pollt één taak totdat deze een eindstatus bereikt:

Resultaatvelden

Succesvolle queryresponsen retourneren gegenereerde afbeeldingen onder data.task_result.images. Elk item kan het volgende bevatten: URL’s van gegenereerde assets kunnen verlopen of door de providerservice worden verwijderd. Sla de voltooide afbeeldingen op in je eigen opslaglaag wanneer je workflow langdurige bewaring nodig heeft.

Autorisaties

Authorization
string
header
vereist

Bearer token authentication. Use your CometAPI API key.

Headers

Content-Type
string

Must be application/json.

Body

application/json
prompt
string
vereist

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>
standaard:1k

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

Beschikbare opties:
1k,
2k,
4k
result_type
enum<string>
standaard:single

Use single for a single-image task.

Beschikbare opties:
single
n
integer
standaard:1

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

Vereist bereik: 1 <= x <= 9
aspect_ratio
enum<string>
standaard:auto

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

Beschikbare opties:
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.

Respons

200 - application/json

Task accepted.

code
integer
vereist

Response code. 0 means the task request was accepted.

message
string
vereist

Response message.

data
object
vereist
request_id
string

Request identifier returned by CometAPI when present.