Langsung ke konten utama
POST
Kirim permintaan asinkron ke POST /v1/images/generations dengan model: "kling-v4-image". Ambil data[0].task_id, lalu periksa hasil melalui GET /v1/tasks/{task_id}.

Autentikasi

string
wajib
Gunakan Authorization: Bearer <token>, dengan <token> sebagai API key APIMart Anda.

Parameter permintaan

string
wajib
Harus kling-v4-image.
boolean
default:"false"
Menentukan apakah moderasi konten dijalankan sebelum tugas gambar dikirim.
  • true: periksa prompt dan gambar input dengan omni-moderation-latest
  • false atau dihilangkan: tidak mengirim permintaan moderasi, tanpa biaya atau latensi moderasi tambahan (default)
string
wajib
Wajib untuk pembuatan dari teks, dari gambar, dan seri. Jelaskan konten yang diinginkan maupun yang ingin dihindari. Batasnya 50.000 karakter untuk teks hanya berbahasa Inggris dan 21.000 untuk teks hanya berbahasa Mandarin atau bahasa serupa; teks campuran dihitung secara proporsional.
string[]
Hingga 10 gambar referensi berupa URL gambar langsung yang dapat diakses publik. Untuk file lokal, gunakan API unggah gambar, lalu kirim url yang dikembalikan.Mendukung JPG / JPEG / PNG / GIF. Setiap gambar maksimal 30 MB, lebar dan tinggi masing-masing minimal 300 px, dengan rasio 2:5–5:2.Gambar referensi diperiksa saat pengiriman. URL yang mengembalikan HTTP 403 / 404 / 410, salah satu sisi kurang dari 300 px, rasio di luar 2:5–5:2, atau ukuran lebih dari 30 MB langsung menghasilkan HTTP 400, tanpa membuat tugas atau mengenakan biaya pembuatan. Kegagalan pengambilan lainnya, seperti waktu tunggu server asal habis, diterima terlebih dahulu; tugas kemudian gagal dan biaya pembuatan yang dipotong di awal dikembalikan sepenuhnya.Gunakan @Image1, @Image2, dan seterusnya dalam prompt untuk merujuk gambar sesuai urutan array. Gambar tetap digunakan sebagai referensi tanpa penanda ini.
integer
default:"1"
Jumlah keluaran dalam mode standar: bilangan bulat 1–9, default 1. Dalam mode seri, n dapat dihilangkan atau diatur ke 1; jumlah keluaran ditentukan oleh sequential_image_generation_options.max_images. Mengirim n > 1 dalam mode seri menghasilkan HTTP 400.
string
default:"2K"
Mendukung 2K (default), 4K, dan 8K, tanpa membedakan huruf besar/kecil. Keluaran berupa PNG. Pada rasio 1:1, 2K adalah 2048×2048, 4K 4096×4096, dan 8K 8192×8192. Untuk rasio lain, gunakan dimensi aktual gambar yang dikembalikan.8K juga mendukung pembuatan dari teks, dari gambar, dan seri: 1–9 keluaran dalam mode standar, 2–4 dalam seri, serta hingga 10 gambar referensi. Persyaratan format, dimensi, dan batas 30 MB per gambar referensi tetap sama.
string
default:"auto"
Rasio aspek keluaran. Mendukung auto (default) dan 8 rasio berikut:16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9.auto memilih rasio berdasarkan prompt atau gambar referensi. Dimensi piksel seperti 2048x2048 tidak didukung.
string
Alias untuk size dengan nilai yang sama. Jika keduanya dikirim, aspect_ratio diprioritaskan.
string
default:"disabled"
disabled atau tidak mengirim kolom ini menggunakan pembuatan standar. auto menghasilkan seri gambar terkait dan mewajibkan sequential_image_generation_options.max_images. Di sini, auto tidak menentukan jumlah gambar secara otomatis.
object
Menentukan jumlah gambar dalam mode seri.
width, height, mask_url, size berbasis piksel, dan watermark: true tidak didukung dan menghasilkan HTTP 400.

Contoh permintaan

Kirim permintaan ini ke POST /v1/images/generations. Ganti URL gambar contoh dengan tautan langsung yang dapat diakses.

Pembuatan dari gambar

Buat tiga gambar 4K

Buat satu gambar 8K

Buat seri empat gambar 8K terkait

Tetapkan max_images ke 2–4. Dalam mode seri, n dapat dihilangkan atau diatur ke 1, tetapi tidak boleh lebih dari 1. Seri dapat memerlukan beberapa menit; simpan task_id dan periksa statusnya agar tidak mengirim permintaan duplikat.

Contoh keluaran 8K dan waktu pemrosesan

Pengukuran berikut merupakan sampel dari lingkungan pengujian. Dimensi, ukuran file, dan waktu hanya sebagai gambaran; hasil aktual dapat berbeda. Periksa setiap 5–10 detik hingga completed atau failed. estimated_time selalu bernilai 60 detik dan tidak boleh digunakan sebagai perkiraan selesai yang sebenarnya atau hitung mundur. Simpan task_id dan jangan kirim ulang permintaan selama menunggu. Hasil 8K berupa PNG asli, dan satu file dapat melebihi 100 MB. Untuk daftar dan pratinjau, gunakan thumbnail yang Anda buat atau muat gambar saat dibutuhkan. Sediakan unduhan file asli dan beri tahu pengguna bahwa ukuran file besar.

Periksa tugas

Baca data.status melalui API kueri tugas: pending / processing berarti sedang diproses, completed berarti berhasil, dan failed memberikan detail di data.error.message.
Berikut adalah contoh struktur hasil yang berhasil. URL gambar ada di data.result.images[].url[]; url berupa array. Ambil semua keluaran dan segera unduh untuk menyimpannya.

Penagihan

Biaya dihitung berdasarkan jumlah gambar aktual dan tingkat resolusi yang dipilih. Gambar referensi ditagih terpisah per gambar. Lihat halaman harga untuk tarifnya.
  • Pembuatan standar dengan n=3 ditagih sebagai 3 keluaran; seri ditagih berdasarkan jumlah yang benar-benar dikembalikan.
  • Setiap referensi dihitung sekali per permintaan, tidak dikalikan dengan jumlah keluaran. Membuat 3 gambar dari 2 referensi berarti 2 masukan dan 3 keluaran yang ditagih.
  • Tugas pembuatan yang gagal tidak dikenai biaya; biaya pembuatan yang dipotong di awal dikembalikan sepenuhnya.

Kesalahan parameter umum

Kesalahan ini mengembalikan HTTP 400 secara sinkron saat pengiriman, tanpa membuat tugas atau mengenakan biaya pembuatan. Baca error.message untuk kesalahan pengiriman dan data.error.message untuk kegagalan setelah tugas dibuat.