Skip to main content
POST
cURL

Generasi gambar

Untuk referensi parameter lengkap, lihat dokumentasi resmi Kling.
Gunakan endpoint ini untuk membuat gambar diam melalui API generasi gambar Kling. Endpoint ini mendukung permintaan khusus teks dan permintaan referensi gambar melalui alur task async yang sama.

Permintaan pertama

Mulailah dengan model_name: kling-v3, prompt, n, dan aspect_ratio. Tambahkan gambar referensi, kontrol fidelity, atau field lanjutan hanya setelah permintaan pertama mengembalikan task yang dapat digunakan. Menghilangkan model_name akan menggunakan default kompatibilitas lama, jadi kirim kling-v3 secara eksplisit untuk integrasi baru.

Baca respons

Simpan task_id yang dikembalikan, lalu lakukan polling pada rute query gambar Kling yang sesuai hingga task_status mencapai status terminal. Jika workflow Anda memerlukan penyimpanan yang tahan lama, salin aset akhir ke lapisan penyimpanan Anda sendiri setelah generasi selesai.

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
prompt
string
wajib

Text prompt describing the image to generate. Maximum 2500 characters.

model_name
enum<string>
default:kling-v1

Kling image model variant. Use kling-v3 for new requests. Omitting model_name uses the legacy CometAPI route default.

Opsi yang tersedia:
kling-v1,
kling-v1-5,
kling-v2,
kling-v2-1,
kling-v3
negative_prompt
string

Elements to exclude from the image. Maximum 2500 characters. Not supported when image is provided.

image
string

Reference image as a raw Base64 string without a data: prefix, or a public URL. Accepted formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300x300 px, aspect ratio between 1:2.5 and 2.5:1.

image_reference
enum<string>

Reference mode for legacy image-to-image requests when image is provided.

Opsi yang tersedia:
subject,
face
image_fidelity
number
default:0.5

How closely the output follows the reference image. Range: 0-1. Used by legacy image-reference models.

Rentang yang diperlukan: 0 <= x <= 1
human_fidelity
number
default:0.45

Human-subject fidelity control. Range: 0-1. Used only by legacy subject-reference requests.

Rentang yang diperlukan: 0 <= x <= 1
element_list
object[]

Optional Kling element references. The total count of element references and input images must not exceed 10.

resolution
enum<string>
default:1k

Output resolution. Defaults to 1k.

Opsi yang tersedia:
1k,
2k
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

Output aspect ratio (width:height).

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 to receive task status updates when the task completes.

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.