Skip to main content
POST
cURL
Bruk dette endepunktet til å opprette en asynkron Kling Omni Image-oppgave gjennom CometAPI. Opprettelsesforespørselen returnerer en task_id; bruk Hent en Kling Omni-bildeoppgave til å polle oppgaven til de genererte bilde-URL-ene er tilgjengelige.
For en fullstendig referanse over leverandørparametere, se dokumentasjonen for Kling Image O1.

Velg forespørselsformatet

  • Generering av enkeltbilde: send prompt, image_list, resolution, result_type: single, n og aspect_ratio
  • Vannmerket resultat: legg til watermark_info.enabled: true når du trenger en URL til et vannmerket resultat i spørringssvaret
  • Modell-ID: utelat model_name for å bruke standardverdien for ruten, eller send en testet Omni Image-modell-ID, for eksempel kling-image-o1 eller kling-v3-omni
Referansebilder bruker image_list-elementer med et image-felt. Prompt-en kan referere til dem etter indeks, for eksempel <<<image_1>>> for det første elementet og <<<image_2>>> for det andre elementet.

Oppgaveflyt

1

Opprett oppgaven

Send POST /kling/v1/images/omni-image og lagre den returnerte data.task_id.
2

Spørr oppgaven

Utfør polling med GET /kling/v1/images/omni-image/ til data.task_status er succeed eller failed.
3

Lagre bildene permanent

Når oppgaven lykkes, kopierer du data.task_result.images[].url til din egen lagring hvis du trenger varig tilgang.
For hele responsskjemaet og detaljer om oppgavestatus, se Hent en Kling Omni-bildeoppgave. Følgende forespørsel spør én oppgave én gang:

Resultatfelt

Vellykkede spørringssvar returnerer genererte bilder under data.task_result.images. Hvert element kan inneholde: URL-er til genererte ressurser kan utløpe eller bli fjernet av leverandørtjenesten. Lagre de ferdige bildene i ditt eget lagringslag når arbeidsflyten krever lang oppbevaring.

Autorisasjoner

Authorization
string
header
påkrevd

Bearer token authentication. Use your CometAPI API key.

Overskrifter

Content-Type
string

Must be application/json.

Kropp

application/json
prompt
string
påkrevd

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.

Tilgjengelige alternativer:
1k,
2k,
4k
result_type
enum<string>
standard:single

Use single for a single-image task.

Tilgjengelige alternativer:
single
n
integer
standard:1

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

Nødvendig område: 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.

Tilgjengelige alternativer:
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.

Svar

200 - application/json

Task accepted.

code
integer
påkrevd

Response code. 0 means the task request was accepted.

message
string
påkrevd

Response message.

data
object
påkrevd
request_id
string

Request identifier returned by CometAPI when present.

Sist endret 31. juli 2026