Skip to main content
POST
cURL
Gunakan endpoint ini untuk membuat task Kling Omni Image asynchronous melalui CometAPI. Permintaan pembuatan mengembalikan task_id; gunakan Mendapatkan task gambar Kling Omni untuk melakukan polling pada task hingga URL gambar yang dihasilkan tersedia.
Untuk referensi parameter penyedia yang lengkap, lihat dokumentasi Kling Image O1.

Pilih bentuk permintaan

  • Pembuatan gambar tunggal: kirim prompt, image_list, resolution, result_type: single, n, dan aspect_ratio
  • Output dengan watermark: tambahkan watermark_info.enabled: true saat Anda memerlukan URL hasil dengan watermark di respons query
  • Model ID: hilangkan model_name untuk menggunakan default route, atau kirim model ID Omni Image yang telah diuji seperti kling-image-o1 atau kling-v3-omni
Gambar referensi menggunakan item image_list dengan field image. Prompt dapat merujuk ke gambar tersebut berdasarkan indeks, seperti <<<image_1>>> untuk item pertama dan <<<image_2>>> untuk item kedua.

Alur task

1

Buat task

Kirim POST /kling/v1/images/omni-image dan simpan data.task_id yang dikembalikan.
2

Query task

Lakukan polling ke GET /kling/v1/images/omni-image/ hingga data.task_status bernilai succeed atau failed.
3

Simpan gambar

Saat task berhasil, salin data.task_result.images[].url ke penyimpanan Anda sendiri jika Anda memerlukan akses yang tahan lama.
Untuk skema respons lengkap dan contoh polling, lihat Mendapatkan task gambar Kling Omni. Contoh singkat berikut melakukan polling pada satu task hingga mencapai status terminal:

Field hasil

Respons query yang berhasil mengembalikan gambar yang dihasilkan di bawah data.task_result.images. Setiap item dapat mencakup: URL aset yang dihasilkan dapat kedaluwarsa atau dihapus oleh layanan penyedia. Simpan gambar yang sudah selesai di lapisan penyimpanan Anda sendiri saat alur kerja Anda memerlukan retensi jangka panjang.

Otorisasi

Authorization
string
header
wajib

Bearer token authentication. Use your CometAPI API key.

Header

Content-Type
string

Must be application/json.

Body

application/json
prompt
string
wajib

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

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

Opsi yang tersedia:
1k,
2k,
4k
result_type
enum<string>
default:single

Use single for a single-image task.

Opsi yang tersedia:
single
n
integer
default:1

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

Rentang yang diperlukan: 1 <= x <= 9
aspect_ratio
enum<string>
default:auto

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

Opsi yang tersedia:
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
wajib

Response code. 0 means the task request was accepted.

message
string
wajib

Response message.

data
object
wajib
request_id
string

Request identifier returned by CometAPI when present.