Kling Image 4.0 · API gambar
Kling Image 4.0 menghasilkan gambar mandiri, seri yang konsisten, halaman detail produk, dan visual web panjang.
Kling Image 4.0
Kling Image 4.0 menghasilkan gambar mandiri, seri yang konsisten, halaman detail produk, dan visual web panjang.
Endpoint
POST https://apimaster.ai/v1/kling/kling-image-4.0/image-generation·single,seriesPOST https://apimaster.ai/v1/kling/kling-image-4.0/long-image-generation·ecommerce,webpageGET https://apimaster.ai/v1/kling/kling-image-4.0/tasks/{task_id}
Parameter permintaan
| Kolom | Nilai |
|---|---|
contents |
JSON · type → prompt, refer_image, element, style_refer_image, subject_refer_image. |
contents[].text |
Sertakan satu prompt yang tidak kosong. Gunakan @id untuk menyebut aset tertentu. |
contents[].id |
Pengenal unik untuk setiap referensi dalam permintaan. |
contents[].url |
URL gambar publik atau Base64. JPG, JPEG, PNG, maksimum 30 MB per gambar, kedua sisi minimal 300 piksel, rasio 2:5–5:2. |
contents[].element_id |
Pengenal elemen gambar milik akun Anda atau preset yang didukung. Dihitung sebagai satu referensi. |
settings.result_type |
single, series. Bawaan single. |
settings.n |
single → 1–9. Bawaan 1. |
settings.series_amount |
series → 2–10 / auto (2–10). Bawaan 4. |
settings.resolution |
single / series → 2k, 4k, 8k. Bawaan 2k. ecommerce / webpage → 1k, 2k. Bawaan 1k. |
settings.aspect_ratio |
single / series → auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9. Bawaan auto. |
settings.skill |
long-image-generation → ecommerce, webpage. |
settings.length |
ecommerce → short, medium, long. Bawaan medium. |
options.watermark_info.enabled |
boolean. Bawaan false. true → outputs[].watermark_url. |
options.callback_url |
URL webhook opsional yang sudah terdaftar dan terverifikasi di akun APIMaster. |
options.external_task_id |
ID korelasi opsional hingga 128 byte, dikembalikan bersama tugas. |
Gambar biasa dan seri menerima total 10 referensi dan elemen. E-commerce memerlukan 1–3 refer_image. Halaman web menerima hingga satu referensi gaya dan satu referensi subjek.
Prompt biasa: 50.000 karakter Inggris atau 21.000 karakter non-Inggris. Gambar panjang: 166.000 atau 71.000. Untuk campuran, jumlah proporsi terhadap kedua batas maksimal 1.
Mode tunggal menghasilkan gambar independen. Seri dikembalikan secara berurutan dan berbagi group_id. Gambar panjang menghasilkan satu gambar lengkap. length khusus e-commerce dan mengatur sekitar 2–5, 6–10, atau 11–18 bagian.
Contoh
single
curl -sS "https://apimaster.ai/v1/kling/kling-image-4.0/image-generation" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: kling-image-example-001" \
-d '{"contents":[{"type":"prompt","text":"A blue ceramic cup in soft daylight"}],"settings":{"resolution":"2k","aspect_ratio":"1:1"}}'
series
{
"contents": [
{
"type": "prompt",
"text": "Create two coordinated studio photographs of the blue ceramic cup in @cup. Show a front view and a detail close-up."
},
{
"type": "refer_image",
"id": "cup",
"url": "https://example.com/cup.png"
}
],
"settings": {
"result_type": "series",
"series_amount": 2,
"resolution": "4k",
"aspect_ratio": "3:4"
},
"options": {
"watermark_info": {
"enabled": true
},
"external_task_id": "campaign-cup-001"
}
}
ecommerce
{
"contents": [
{
"type": "prompt",
"text": "Design a product detail page for @cup. Include a hero image, material details, and care instructions."
},
{
"type": "refer_image",
"id": "cup",
"url": "https://example.com/cup.png"
}
],
"settings": {
"skill": "ecommerce",
"length": "short",
"resolution": "1k"
}
}
webpage
{
"contents": [
{
"type": "prompt",
"text": "Design a long product landing page for a ceramic cup collection."
}
],
"settings": {
"skill": "webpage",
"resolution": "2k"
}
}
Hasil tugas
Simpan task_id dan periksa dengan akun yang sama. Saat berhasil, outputs berisi URL gambar beserta watermark_url dan group_id opsional. Saat gagal, baca error.
curl -sS "https://apimaster.ai/v1/kling/kling-image-4.0/tasks/TASK_ID" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"task_id": "task_example",
"object": "image",
"model": "kling-image-4.0",
"status": "completed",
"outputs": [{"type": "image", "url": "https://example.com/generated.png"}]
}
Gunakan kembali Idempotency-Key untuk permintaan yang sama. Setelah waktu habis, periksa tugas awal.
Penagihan
Biaya dihitung dari gambar yang diterima pada tarif keluaran ditambah referensi pada tarif masukan. Lihat harga pelanggan di marketplace. Kling Image 4.0
