Skip to main content
POST
cURL
Gebruik dit endpoint om via CometAPI een asynchrone Kling Omni Image-taak 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 parameterreferentie van de provider de Kling Image O1-documentatie.

Kies de aanvraagvorm

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

Taakstroom

1

Maak de taak

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

Vraag de taak op

Voer een poll uit met GET /kling/v1/images/omni-image/ totdat data.task_status de waarde succeed of failed heeft.
3

Bewaar de afbeeldingen

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 antwoordschema en details over de taakstatus Een Kling Omni Image-taak ophalen. De volgende aanvraag vraagt één taak één keer op:

Resultaatvelden

Succesvolle queryantwoorden 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 vereist.

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.

Laatst gewijzigd op 31 juli 2026