
Kling Image 4.0 API memberi developer akses ke model gambar terbaru Kling AI melalui satu endpoint PoYo: panggil kling-4.0-image untuk text-to-image, editing, dan set gambar pada 2K, 4K, atau 8K, serta kling-4.0-long-image untuk desain halaman web penuh atau halaman ecommerce. Halaman ini membahas apa itu Kling Image 4.0, fungsi setiap field request, batasannya, dan biaya satu panggilan di PoYo.
Apa itu Kling Image 4.0?
Kling Image 4.0 adalah model gambar dari keluarga Kling 4.0 buatan Kling AI, platform kreatif AI milik Kuaishou. Model ini dirilis pada 17 November 2026. Dalam postingan peluncurannya, Kling menyebut model ini:
- menghasilkan gambar pada 8K native, yang untuk pertama kalinya diperkenalkan Kling lewat model ini;
- membuat hingga 10 gambar dari satu prompt dengan gaya dan konten yang konsisten;
- merender hingga 2,000 karakter teks dalam satu gambar, dalam bahasa Inggris, Mandarin Sederhana, Mandarin Tradisional, Jepang, Korea, Spanyol, dan Portugis;
- menghasilkan gambar format panjang untuk halaman detail produk ecommerce dan desain web.
Kling juga menyatakan model ini sudah tersedia di Kling Creative Studio dan dapat diakses melalui API oleh perusahaan dan developer. PoYo menambahkan Kling Image 4.0 API pada November 2026, tanpa daftar tunggu dan dengan API key yang sama yang Anda gunakan untuk semua model PoYo lainnya.
ID model Kling Image 4.0 API di PoYo
| ID model | Gunakan untuk | Output |
|---|---|---|
kling-4.0-image | Text-to-image (tanpa image_urls), image-to-image dengan 1–10 referensi, elements, set gambar | 1–9 gambar independen, atau satu set berisi 2–10, pada 2K / 4K / 8K |
kling-4.0-long-image | Desain halaman skill: "webpage", halaman detail produk skill: "ecommerce" dari 1–3 foto produk | Satu gambar tinggi, lebar 1024 px (1K) atau 2048 px (2K) |
Kedua ID memakai endpoint submit yang sama, polling task yang sama, dan webhook callback_url yang sama. Slug halaman landing adalah kling-4-0-image; ID model pada request memakai titik (kling-4.0-image).
Endpoint dan bentuk request
Setiap request Kling Image 4.0 API adalah task asinkron:
POST https://api.poyo.ai/api/generate/submitdenganAuthorization: Bearer $POYO_API_KEYdan body JSON berisimodelsertainput.- Baca
data.task_iddari respons. - Lakukan polling
GET https://api.poyo.ai/api/generate/status/{task_id}hinggastatusbernilaifinishedataufailed, atau kirimcallback_urldi level atas dan terima POST saat task selesai.
Request 4K minimal, disalin dari bentuk di dokumentasi:
{
"model": "kling-4.0-image",
"input": {
"prompt": "High fashion model wearing a dress made of living moss, standing in an abandoned greenhouse, shafts of light, editorial photography",
"size": "16:9",
"resolution": "4K"
}
}
Task yang selesai mengembalikan gambar di data.files, masing-masing dengan file_url dan file_type: "image". Set gambar dikembalikan sesuai urutan. Periksa field code di body selain status HTTP: PoYo bisa mengembalikan HTTP 200 dengan code: 400 untuk error validasi. Versi langkah demi langkah dengan cURL dan Python ada di panduan Kling Image 4.0 API.
Field input dan batasan
kling-4.0-image
| Field | Nilai | Catatan |
|---|---|---|
prompt | 1–50,000 karakter | Wajib. Rujuk input sebagai @Image1, @Element1 |
image_urls | 1–10 URL | Memilih mode image-to-image. Setiap gambar maksimal 30 MB, minimal 300 px per sisi, rasio aspek 0.4–2.5 |
kling_elements | hingga 7 element | Masing-masing {"element_input_urls": [...]} dengan 2–4 sudut pandang, tampak depan lebih dulu. Memerlukan image_urls. Gambar plus element ≤ 10 |
size | auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9 | Default auto |
resolution | 2K, 4K, 8K | Default 2K. 8K adalah 8192×8192 pada 1:1 |
enable_sequential | true / false | true mengembalikan set gambar yang koheren |
n | 1–9 (independen) atau 2–10 (set) | Default 1 dan 4 |
Skema menolak field yang tidak dikenal, jadi jangan kirim output_format, seed, atau negative_prompt. Output berformat PNG.
kling-4.0-long-image
| Field | Nilai | Catatan |
|---|---|---|
skill | webpage (default), ecommerce | Memilih jenis halaman |
image_urls | 1–3 foto produk | Wajib untuk ecommerce |
style_image_url / subject_image_url | masing-masing satu URL | Hanya webpage; @StyleImage, @SubjectImage |
length | short, medium (default), long | Hanya ecommerce: sekitar 2–5, 6–10, atau 11–18 bagian |
resolution | 1K (default), 2K | Lebar 1024 atau 2048 px; tinggi mengikuti konten |
Setiap request long image mengembalikan satu gambar.
Harga Kling Image 4.0 API di PoYo
PoYo menagih per gambar yang dihasilkan (1 kredit = $0.005). Kredit hanya dipotong jika task berhasil.
| Request | Kredit | USD |
|---|---|---|
kling-4.0-image, 2K, per gambar | 13 | $0.065 |
kling-4.0-image, 4K, per gambar | 19 | $0.095 |
kling-4.0-image, 8K, per gambar | 32 | $0.16 |
Setiap item image_urls dan setiap element kling_elements, sekali per request | 1 | $0.005 |
| Long image, webpage, 1K / 2K | 110 / 120 | $0.55 / $0.60 |
| Long image, ecommerce short, 1K / 2K | 47 / 57 | $0.235 / $0.285 |
| Long image, ecommerce medium, 1K / 2K | 94 / 110 | $0.47 / $0.55 |
| Long image, ecommerce long, 1K / 2K | 157 / 173 | $0.785 / $0.865 |
Long image, setiap gambar di image_urls, style_image_url, atau subject_image_url | 1 | $0.005 |
Rincian harga memuat tabel long image dan contoh perhitungan.
Hasil pengukuran kami pada hari peluncuran
Tim PoYo menjalankan request berikut di API produksi pada 19 November 2026. Waktu dihitung dari submit hingga hasil sebagaimana terlihat oleh klien polling, jadi anggap sebagai perkiraan.
| Request | Output | Biaya | Waktu |
|---|---|---|---|
kling-4.0-image, text-to-image, 16:9, 8K, n: 1 | PNG 10880×6144, sekitar 128 MB | 32 kredit | sekitar 3.8 menit |
kling-4.0-image, 16:9, 2K, enable_sequential: true, n: 4 | empat gambar 2720×1536, pengendara, sepeda, dan pakaian yang sama dari fajar hingga malam | 52 kredit | sekitar 4.9 menit |
kling-4.0-long-image, skill: "webpage", 1K | satu halaman 1024×4257 | 110 kredit | sekitar 1.7–2.2 menit |
Dua catatan integrasi dari pengujian yang sama. File unduhan berupa PNG dengan kanal alpha (RGBA) bahkan untuk gambar yang tidak transparan, jadi lakukan konversi secara eksplisit jika pipeline Anda mengharapkan RGB atau JPEG. Selain itu, prompt webpage panjang dalam bahasa Inggris yang tidak menyebutkan bahasa untuk teks halaman justru menghasilkan teks berbahasa Mandarin; menambahkan "All text on the page is in English." memperbaikinya. Penjelasan lebih lanjut tentang keduanya ada di gambar 8K dan long image.
Request mana yang sebaiknya dikirim ke Kling Image 4.0 API?
- Pekerjaan cetak, billboard, dan yang banyak memerlukan crop yang butuh lebih dari 4K: ini satu-satunya model gambar di PoYo dengan tingkat
8K. - Storyboard, sudut produk, dan slide deck di mana satu karakter atau produk harus tetap sama di setiap frame: gunakan
enable_sequential. - Menempatkan produk atau karakter yang sudah ada ke adegan baru: kirim adegan di
image_urlsdan subjek sebagai element multi-sudut. - Mockup landing page dan halaman detail ecommerce sebagai satu gambar:
kling-4.0-long-image.
Untuk draf cepat 1K–2K dengan harga terendah, Kling O3 Image lebih murah per gambar; lihat Kling Image 4.0 API vs Kling O3 Image. Untuk membandingkannya dengan vendor lain, baca Kling Image 4.0 vs GPT Image 2.6 vs Seedream 5.5.
Pertanyaan yang sering diajukan
Apa itu Kling Image 4.0 API?
Ini adalah akses REST PoYo ke model Kling Image 4.0 dari Kling AI, dengan ID model kling-4.0-image (gambar standar, edit, dan set gambar) dan kling-4.0-long-image (halaman webpage dan ecommerce panjang). Keduanya memakai POST /api/generate/submit dan API key yang sama.
Berapa biaya Kling Image 4.0 API? 13 kredit ($0.065) per gambar pada 2K, 19 kredit ($0.095) pada 4K, dan 32 kredit ($0.16) pada 8K, ditambah 1 kredit ($0.005) per gambar referensi atau element, sekali per request. Long image berharga 47 hingga 173 kredit per halaman. Task yang gagal tidak ditagih.
Apakah Kling Image 4.0 API mendukung image-to-image?
Ya. Kirim 1 hingga 10 URL di image_urls dengan kling-4.0-image dan rujuk di prompt sebagai @Image1, @Image2. Tambahkan hingga 7 kling_elements untuk karakter atau objek yang konsisten; jumlah gambar plus element dibatasi 10.
Berapa lama sebuah request Kling Image 4.0 API?
Dalam uji hari peluncuran kami, satu gambar 16:9 8K memakan sekitar 3.8 menit, satu set empat gambar 2K sekitar 4.9 menit, dan satu webpage 1K sekitar 2 menit. Gunakan callback_url alih-alih menahan request tetap terbuka untuk pekerjaan besar.
Di mana dokumentasi Kling Image 4.0 API? Referensi field ada di dokumentasi Kling Image 4.0 dan dokumentasi long image. Halaman model memiliki playground yang menampilkan JSON sesuai pengaturan Anda.