
Kling Image 4.0 API (kling-4.0-image) adalah penerus Kling O3 Image API (kling-o3-image dan kling-o3-image-edit) di PoYo. Versi singkatnya: Kling Image 4.0 menambahkan 8K, set gambar, prompt 50,000 karakter, dan model halaman panjang terpisah, dengan biaya kira-kira tiga hingga empat kali lipat per gambar. Artikel ini membandingkan keduanya request demi request agar Anda bisa memutuskan panggilan mana yang perlu dipindahkan. Keduanya tersedia di PoYo: Kling Image 4.0 dan Kling O3 Image.
Keputusan dalam satu tabel
| Jika request Anda membutuhkan… | Panggil |
|---|---|
| Output 1K, atau harga per gambar terendah | kling-o3-image / kling-o3-image-edit |
| JPEG atau WebP langsung dari API | Kling O3 Image (output_format) |
| Lebih dari 4K, atau tepat 8K | kling-4.0-image |
| Set berisi 2–10 gambar dengan subjek dan gaya yang sama | kling-4.0-image dengan enable_sequential |
| Prompt lebih dari 2,000 karakter | kling-4.0-image (hingga 50,000) |
| Halaman web penuh atau halaman detail ecommerce sebagai satu gambar | kling-4.0-long-image |
| Text-to-image dan editing dalam satu ID model | kling-4.0-image |
Perbedaan request per field
Keduanya memakai POST https://api.poyo.ai/api/generate/submit, endpoint status yang sama, dan callback_url yang sama. Perbedaannya ada di model dan input, diambil dari dokumentasi PoYo masing-masing model.
| Field | Kling O3 Image | Kling Image 4.0 API |
|---|---|---|
model | kling-o3-image (text-to-image), kling-o3-image-edit (edit) | kling-4.0-image untuk keduanya; image_urls memilih mode edit |
prompt | hingga 2,000 karakter | 1–50,000 karakter |
image_urls | 1–10, wajib untuk kling-o3-image-edit | 1–10 (opsional); masing-masing 30 MB, ≥300 px, rasio 0.4–2.5 |
| Elements | elements: [{frontal_image_url, reference_image_urls}] | kling_elements: [{element_input_urls: [front, …]}], 2–4 sudut pandang, hingga 7, gambar + element ≤ 10 |
resolution | 1K (default), 2K, 4K | 2K (default), 4K, 8K |
size | 8 rasio, default 16:9; auto hanya di model edit | 8 rasio yang sama plus auto, default auto |
output_format | jpeg, png (default), webp | tidak diterima; hanya PNG |
n | 1–9 | 1–9 independen, atau 2–10 dengan enable_sequential: true |
enable_sequential | tidak tersedia | true mengembalikan set yang berurutan dan konsisten |
| Halaman panjang | tidak tersedia | model terpisah kling-4.0-long-image |
Dalam postingan peluncurannya, Kling menggambarkan Kling Image 4.0 sebagai model pertamanya dengan generasi 8K native, yang mampu merencanakan hingga 10 gambar dari satu prompt dan merender hingga 2,000 karakter teks dalam tujuh bahasa. Itu klaim Kling; perbedaan API di atas adalah hal yang berubah di kode Anda.
Harga untuk request yang sama
Harga PoYo, 1 kredit = $0.005. Kling O3 Image tidak memiliki biaya tambahan referensi di PoYo; Kling Image 4.0 API menambahkan 1 kredit per gambar referensi atau element, sekali per request. Halaman harga Kling sendiri mencatat perubahan yang sama: Kling Image 4.0 menagih input referensi, model sebelumnya tidak.
| Request yang sama | Kling O3 Image | Kling Image 4.0 API |
|---|---|---|
| 1 gambar, 1K | 3.5 kredit ($0.0175) | tidak tersedia (minimal 2K: 13 kredit) |
| 1 gambar, 2K | 3.5 kredit ($0.0175) | 13 kredit ($0.065) |
| 1 gambar, 4K | 7 kredit ($0.035) | 19 kredit ($0.095) |
| 1 gambar, 8K | tidak tersedia | 32 kredit ($0.16) |
| Edit 2K, 2 gambar referensi + 1 element | 3.5 kredit ($0.0175) | 16 kredit ($0.08) |
| 4 gambar pada 2K | 14 kredit ($0.07), independen | 52 kredit ($0.26), sebagai set atau independen |
| Desain webpage, 1K | tidak tersedia | 110 kredit ($0.55) |
Pada 2K, Kling Image 4.0 API berbiaya sekitar 3.7× Kling O3 Image per gambar, dan sekitar 2.7× pada 4K. Tabel lengkap Kling Image 4.0 ada di harga Kling Image 4.0 API.
Batasan yang berubah
- Batas bawah resolusi naik. 1K sudah tidak ada; output Kling Image 4.0 terkecil adalah 2K. Jika Anda menyajikan thumbnail, tetap gunakan O3 atau ubah ukurannya di sisi Anda.
- Batas atas naik ke 8K. Dokumentasi PoYo mencantumkan 8192×8192 pada 1:1. Dalam uji hari peluncuran kami (API produksi PoYo, 19 November 2026), request 8K 16:9 mengembalikan PNG 10880×6144 berukuran sekitar 128 MB dan memakan sekitar 3.8 menit, seharga 32 kredit.
- Penanganan file. Tidak ada
output_format: Anda mendapatkan PNG. File unduhan kami berupa PNG RGBA bahkan untuk gambar yang tidak transparan. Rencanakan konversi dan penyimpanan jika Anda memakaijpegatauwebpdi O3. - Aturan referensi lebih eksplisit. Kling Image 4.0 memvalidasi setiap referensi: maksimal 30 MB, minimal 300 px per sisi, lebar/tinggi antara 0.4 dan 2.5. Dokumentasi O3 tidak mencantumkan batasan seperti ini, jadi validasi gambar yang sangat lebar atau kecil sebelum migrasi.
- Set butuh waktu lebih lama. Set empat gambar 2K kami memakan sekitar 4.9 menit. Pindahkan pekerjaan yang lama atau besar ke
callback_url.
Kapan harus beralih
Pindahkan sebuah panggilan ke kling-4.0-image ketika panggilan itu membutuhkan sesuatu yang tidak bisa dilakukan O3: 8K, set yang konsisten, prompt panjang, atau desain halaman. Contohnya:
- Storyboard dan sudut produk. Di O3 Anda akan mengirim
n: 4dan berharap subjeknya cocok. Denganenable_sequential: true, model merencanakan set tersebut; uji kami mempertahankan pengendara, sepeda, dan pakaian yang sama pada fajar, siang, senja, dan malam. - Aset cetak dan yang banyak di-crop. Apa pun di atas 4K.
- Prompt panjang dan terstruktur. Panduan merek, daftar shot, dan blok teks lebih dari 2,000 karakter.
- Halaman ecommerce.
kling-4.0-long-imagemembangun seluruh halaman detail; O3 tidak punya padanannya.
Tetap gunakan O3 untuk draf 1K–2K bervolume tinggi, thumbnail, dan pipeline yang membutuhkan JPEG atau WebP dari API. Menjalankan keduanya tidak masalah: O3 untuk eksplorasi, Kling Image 4.0 untuk set final, dengan key yang sama.
Diff migrasi
Panggilan text-to-image:
{
- "model": "kling-o3-image",
+ "model": "kling-4.0-image",
"input": {
"prompt": "A cinematic futuristic alley with rain and neon reflections",
"resolution": "4K",
"size": "16:9",
- "output_format": "png",
"n": 2
}
}
Edit dengan element. Dua field berganti nama, dua ID model digabung menjadi satu:
{
- "model": "kling-o3-image-edit",
+ "model": "kling-4.0-image",
"input": {
"prompt": "Place @Element1 sitting on the sofa in @Image1. Keep the room layout of @Image1 unchanged.",
"image_urls": ["https://example.com/living-room.png"],
- "elements": [
- {
- "frontal_image_url": "https://example.com/character-front.png",
- "reference_image_urls": ["https://example.com/character-side.png"]
- }
- ],
+ "kling_elements": [
+ {
+ "element_input_urls": [
+ "https://example.com/character-front.png",
+ "https://example.com/character-side.png"
+ ]
+ }
+ ],
- "resolution": "1K",
- "size": "auto",
- "output_format": "png"
+ "resolution": "2K",
+ "size": "auto"
}
}
Checklist:
- Ganti kedua ID model O3 dengan
kling-4.0-image; mode edit kini ditentukan olehimage_urls. - Ganti nama
elementsmenjadikling_elementsdan gabungkanfrontal_image_urlplusreference_image_urlske dalam satu arrayelement_input_urls, tampak depan lebih dulu, total 2–4 URL. Element O3 dengan satu sudut pandang memerlukan setidaknya satu sudut pandang tambahan. - Hapus
output_format. Skema menolak field yang tidak dikenal. - Ubah
1Kmenjadi2K; atursizesecara eksplisit jika Anda mengandalkan default16:9dari O3, karena default baru adalahauto. - Tambahkan biaya tambahan referensi ke estimasi biaya Anda.
- Naikkan timeout klien atau beralih ke webhook untuk 8K dan set.
Polling status, parsing files[].file_url, dan verifikasi webhook tetap sama. Referensi request lengkap ada di panduan Kling Image 4.0 API.
Bagaimana dengan Kling O1 Image?
Kling O1 Image hanya untuk edit (kling-o1-image-edit) pada 1K atau 2K dengan harga 3.5 kredit per gambar. Perlakukan seperti kling-o3-image-edit pada tabel di atas: edit referensi yang murah, tanpa 4K atau 8K, tanpa set.
Pertanyaan yang sering diajukan
Apakah Kling Image 4.0 API bisa langsung menggantikan Kling O3 Image API?
Hampir. Endpoint, autentikasi, polling, dan webhook sama. Anda mengganti ID model, mengganti nama elements menjadi kling_elements, menghapus output_format, dan memindahkan request 1K ke 2K.
Mana yang lebih murah, Kling Image 4.0 API atau Kling O3 Image? Kling O3 Image: 3.5 kredit per gambar pada 1K atau 2K dan 7 pada 4K, dibandingkan 13, 19, dan 32 kredit pada 2K, 4K, dan 8K untuk Kling Image 4.0, yang juga menambahkan 1 kredit per referensi.
Apakah Kling O3 Image mendukung 8K atau set gambar?
Tidak. Kling O3 Image di PoYo maksimal 4K dan mengembalikan 1–9 gambar independen. 8K dan set enable_sequential adalah fitur Kling Image 4.0 API.
Apakah saya masih bisa mendapatkan JPEG dari Kling Image 4.0 API? Tidak dari API: output-nya PNG. Konversikan setelah diunduh, atau tetap jalankan pekerjaan JPEG dan WebP di Kling O3 Image.
Apakah saya perlu API key baru untuk Kling Image 4.0 API?
Tidak. Key PoYo yang sama berfungsi untuk kling-4.0-image, kling-4.0-long-image, kling-o3-image, dan semua model lainnya.