Skip to main content
POST
cURL
Gunakan endpoint ini saat Anda ingin Kling menghasilkan satu gambar dari beberapa referensi subjek ditambah referensi adegan atau gaya opsional.

Sebelum Anda memanggilnya

  • Sediakan 1 hingga 4 gambar dalam subject_image_list
  • Gunakan model_name: kling-v2-1 untuk request baru
  • Tambahkan scene_image atau style_image hanya ketika komposisi subjek inti sudah berfungsi
  • Perlakukan ini sebagai rute generasi async dan simpan task id yang dikembalikan

Alur task

1

Kirim task pembuatan gambar

Kirim daftar gambar subjek dan prompt, lalu simpan task id yang dikembalikan.
2

Poll task

Lakukan poll pada task yang dikembalikan dengan path query gambar Kling yang sesuai hingga task mencapai status terminal.
3

Simpan hasilnya

Simpan gambar yang dihasilkan ke penyimpanan Anda sendiri jika Anda memerlukan akses yang persisten.
Untuk referensi parameter lengkap, lihat dokumentasi resmi Kling.

Otorisasi

Authorization
string
header
wajib

Bearer token authentication. Use your CometAPI key.

Header

Content-Type
string
default:application/json

Must be application/json.

Body

application/json
subject_image_list
object[]
wajib

Subject reference images. Minimum 1, maximum 4.

Required array length: 1 - 4 elements
model_name
enum<string>
default:kling-v2

Model to use for multi-image generation. Use kling-v2-1 for new requests; omitting the field uses the legacy route default.

Opsi yang tersedia:
kling-v2,
kling-v2-1
prompt
string

Text prompt describing the desired output. Maximum 2500 characters.

negative_prompt
string

Elements to exclude from the image. Maximum 2500 characters.

scene_image
string

Optional scene reference image. Image URL or raw Base64 string without a data: prefix. Supported formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300x300 px, aspect ratio between 1:2.5 and 2.5:1.

style_image
string

Optional style reference image. Image URL or raw Base64 string without a data: prefix. Supported formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300x300 px, aspect ratio between 1:2.5 and 2.5:1.

n
integer
default:1

Number of images to generate. Range: 1-9.

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

Aspect ratio of the generated image.

Opsi yang tersedia:
16:9,
9:16,
1:1,
4:3,
3:4,
3:2,
2:3,
21:9
watermark_info
object

Watermark options.

callback_url
string

Webhook URL for task status notifications.

external_task_id
string

Optional user-defined task ID for your own tracking. Must be unique per account.

Respons

200 - application/json

Task request accepted or an error response returned by the API.

code
wajib

Response code. 0 means the task request was accepted.

message
string
wajib

Response message.

data
object
wajib
request_id
string

Request identifier returned when present.