Langsung ke konten utama
POST
Kirim permintaan asinkron ke POST /v1/images/generations dengan model: "kling-v4-long-image". Ambil data[0].task_id, lalu periksa GET /v1/tasks/{task_id}. Setiap permintaan menghasilkan satu PNG panjang; mode web menghasilkan gambar desain halaman.

Pilih mode

Autentikasi

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

Parameter permintaan

string
wajib
Harus kling-v4-long-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 dan tidak boleh hanya spasi. Maksimal 166.000 karakter untuk bahasa Inggris saja dan 71.000 untuk Mandarin atau bahasa serupa; teks campuran dihitung proporsional. Jelaskan tata letak, bagian konten, teks, gaya, dan subjek.
string
wajib
Wajib: ecommerce untuk detail produk atau webpage untuk desain halaman web, tanpa membedakan huruf besar/kecil. Setiap mode memakai kolom referensi berbeda.
string
default:"medium"
Hanya untuk skill: "ecommerce": short, medium (default), atau long, kira-kira 2–5, 6–10, atau 11–18 bagian konten. Konten dan tinggi aktual bergantung pada hasil. Hilangkan kolom ini pada mode web; mengirimnya menghasilkan HTTP 400.
string
default:"1K"
Mendukung 1K (default) dan 2K, tanpa membedakan huruf besar/kecil, untuk semua panjang ecommerce termasuk long + 2K. Lebar keluaran masing-masing 1024 dan 2048 px; tingginya bergantung pada konten. 4K tidak didukung.
string[]
Hanya untuk ecommerce: wajib 1–3 gambar produk. Pada mode web, hilangkan kolom ini dan gunakan image_with_roles. Berikan URL gambar langsung yang publik. File lokal dapat diunggah melalui API unggah gambar, lalu gunakan url yang dikembalikan.
object[]
Opsional, hanya untuk web. Maksimal satu gambar style dan satu subject; salah satu atau keduanya boleh dihilangkan. Hilangkan kolom ini pada mode ecommerce.
integer
Setiap permintaan menghasilkan satu gambar panjang. Hilangkan kolom ini atau gunakan bilangan bulat 1; nilai lain menghasilkan HTTP 400.
boolean
Hilangkan kolom ini atau gunakan false; true menghasilkan HTTP 400.
Jangan kirim size, aspect_ratio, width, height, mask_url, sequential_image_generation, atau sequential_image_generation_options. Nilai null atau string kosong pada kolom tersebut juga menghasilkan HTTP 400.

Persyaratan dan penanda referensi

Mendukung JPG / JPEG / PNG. Maksimal 30 MB per gambar, kedua sisi minimal 300 px, rasio 2:5–5:2. URL dengan HTTP 403 / 404 / 410, dimensi atau rasio tidak valid, atau file terlalu besar mengembalikan HTTP 400 sinkron, tanpa tugas atau biaya pembuatan. Kegagalan lain seperti waktu tunggu server asal habis diterima terlebih dahulu; tugas kemudian gagal dan biaya di muka dikembalikan. Gunakan @Image1, @Image2, dan seterusnya dalam prompt. Ecommerce mengikuti urutan image_urls; web mengikuti gaya lalu subjek. Jika hanya satu gambar diberikan, gambar itu adalah @Image1.

Contoh permintaan

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

Halaman produk panjang dalam 2K

Web dengan referensi gaya dan subjek

Web hanya dari prompt

Periksa tugas

Periksa API kueri tugas sekitar setiap 10 detik. Simpan task_id dan hindari permintaan pembuatan duplikat meskipun menunggu lama.
Berikut adalah struktur hasil yang berhasil. images dan url berupa array; model ini menghasilkan satu gambar panjang per permintaan.
Unduh sebelum timestamp Unix dalam detik pada data.result.images[0].expires_at. Tautan akan kedaluwarsa setelahnya.
Pembuatan biasanya memerlukan beberapa menit; satu sampel long + 2K memerlukan 432 detik. estimated_time saat ini selalu bernilai 60 detik, jadi jangan gunakan sebagai hitung mundur atau batas waktu. Durasi bergantung pada konten dan beban layanan; sampel bukan batas maksimum.Tinggi dan ukuran file bergantung pada konten. Satu sampel long + 2K berukuran 2048×46615 dan 63,9 MB; ini bukan batas keluaran. Hasil dapat melebihi 50 MB, jadi pertimbangkan biaya pengunduhan dan penampilan gambar besar.

Penagihan

Setiap permintaan ditagih untuk satu gambar panjang pada tingkat keluaran yang dipilih, ditambah referensi: harga tingkat keluaran + jumlah referensi × harga per referensi. Gambar produk, gaya, dan subjek semuanya dihitung; referensi pertama juga dikenai biaya. Ada 8 tingkat keluaran di bawah. Kunci harga: kling-v4-long-image@<tingkat> dan kling-v4-long-image@input untuk referensi. Dalam permintaan pembuatan, resolution tetap hanya menerima 1K atau 2K. Biaya dipotong saat pengiriman, diselesaikan saat berhasil, dan dikembalikan sepenuhnya saat gagal. Lihat halaman harga untuk tarif dan diskon akun.

Kesalahan umum

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