curl --request POST \
--url https://api.apimart.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-v4-image",
"prompt": "An orange cat sitting on a windowsill in warm afternoon sunlight, realistic photography",
"size": "1:1",
"resolution": "2K",
"n": 1,
"nsfw_check": true
}'
import requests
payload = {
"model": "kling-v4-image",
"prompt": "An orange cat sitting on a windowsill in warm afternoon sunlight, realistic photography",
"size": "1:1",
"resolution": "2K",
"n": 1,
"nsfw_check": True
}
response = requests.post(
"https://api.apimart.ai/v1/images/generations",
headers={"Authorization": "Bearer <token>"},
json=payload,
timeout=60,
)
response.raise_for_status()
print(response.json())
const payload = {
"model": "kling-v4-image",
"prompt": "An orange cat sitting on a windowsill in warm afternoon sunlight, realistic photography",
"size": "1:1",
"resolution": "2K",
"n": 1,
"nsfw_check": true
};
const response = await fetch("https://api.apimart.ai/v1/images/generations", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify(payload)
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_example_kling_v4_image"
}
]
}
{
"error": {
"code": 400,
"message": "`prompt` is required for kling-v4-image",
"type": "invalid_request_error"
}
}
Kling V4 Image
Pembuatan Gambar Kling V4 Image
Buat gambar dari teks atau hingga 10 gambar referensi, serta seri berisi 2–4 gambar terkait. Mode standar menghasilkan 1–9 gambar PNG 2K / 4K / 8K per permintaan.
POST
/
v1
/
images
/
generations
curl --request POST \
--url https://api.apimart.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-v4-image",
"prompt": "An orange cat sitting on a windowsill in warm afternoon sunlight, realistic photography",
"size": "1:1",
"resolution": "2K",
"n": 1,
"nsfw_check": true
}'
import requests
payload = {
"model": "kling-v4-image",
"prompt": "An orange cat sitting on a windowsill in warm afternoon sunlight, realistic photography",
"size": "1:1",
"resolution": "2K",
"n": 1,
"nsfw_check": True
}
response = requests.post(
"https://api.apimart.ai/v1/images/generations",
headers={"Authorization": "Bearer <token>"},
json=payload,
timeout=60,
)
response.raise_for_status()
print(response.json())
const payload = {
"model": "kling-v4-image",
"prompt": "An orange cat sitting on a windowsill in warm afternoon sunlight, realistic photography",
"size": "1:1",
"resolution": "2K",
"n": 1,
"nsfw_check": true
};
const response = await fetch("https://api.apimart.ai/v1/images/generations", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify(payload)
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_example_kling_v4_image"
}
]
}
{
"error": {
"code": 400,
"message": "`prompt` is required for kling-v4-image",
"type": "invalid_request_error"
}
}
curl --request POST \
--url https://api.apimart.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-v4-image",
"prompt": "An orange cat sitting on a windowsill in warm afternoon sunlight, realistic photography",
"size": "1:1",
"resolution": "2K",
"n": 1,
"nsfw_check": true
}'
import requests
payload = {
"model": "kling-v4-image",
"prompt": "An orange cat sitting on a windowsill in warm afternoon sunlight, realistic photography",
"size": "1:1",
"resolution": "2K",
"n": 1,
"nsfw_check": True
}
response = requests.post(
"https://api.apimart.ai/v1/images/generations",
headers={"Authorization": "Bearer <token>"},
json=payload,
timeout=60,
)
response.raise_for_status()
print(response.json())
const payload = {
"model": "kling-v4-image",
"prompt": "An orange cat sitting on a windowsill in warm afternoon sunlight, realistic photography",
"size": "1:1",
"resolution": "2K",
"n": 1,
"nsfw_check": true
};
const response = await fetch("https://api.apimart.ai/v1/images/generations", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify(payload)
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_example_kling_v4_image"
}
]
}
{
"error": {
"code": 400,
"message": "`prompt` is required for kling-v4-image",
"type": "invalid_request_error"
}
}
POST /v1/images/generations dengan model: "kling-v4-image". Ambil data[0].task_id, lalu periksa hasil melalui GET /v1/tasks/{task_id}.
Autentikasi
Parameter permintaan
Menentukan apakah moderasi konten dijalankan sebelum tugas gambar dikirim.
true: periksa prompt dan gambar input denganomni-moderation-latestfalseatau dihilangkan: tidak mengirim permintaan moderasi, tanpa biaya atau latensi moderasi tambahan (default)
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.
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.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.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.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.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.width, height, mask_url, size berbasis piksel, dan watermark: true tidak didukung dan menghasilkan HTTP 400.Contoh permintaan
Kirim permintaan ini kePOST /v1/images/generations. Ganti URL gambar contoh dengan tautan langsung yang dapat diakses.
Pembuatan dari gambar
curl --request POST \
--url https://api.apimart.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-v4-image",
"prompt": "Use the dog in @Image1 as a reference for a 3D animated character poster, preserving its fur color and features",
"image_urls": [
"https://example.com/dog.png"
],
"size": "3:4",
"resolution": "2K"
}'
Buat tiga gambar 4K
curl --request POST \
--url https://api.apimart.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-v4-image",
"prompt": "A quiet mountain lake at sunrise, detailed landscape photography",
"size": "16:9",
"resolution": "4K",
"n": 3
}'
Buat satu gambar 8K
curl --request POST \
--url https://api.apimart.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-v4-image",
"prompt": "A sweeping aerial view of a misty mountain valley at sunrise",
"resolution": "8K",
"size": "16:9",
"n": 1
}'
Buat seri empat gambar 8K terkait
Tetapkanmax_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.
curl --request POST \
--url https://api.apimart.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-v4-image",
"prompt": "The same tree in spring, summer, autumn, and winter, consistent picture-book style",
"sequential_image_generation": "auto",
"sequential_image_generation_options": {
"max_images": 4
},
"size": "3:4",
"resolution": "8K"
}'
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.| Permintaan 8K | Dimensi keluaran | Ukuran file per gambar | Waktu hingga selesai |
|---|---|---|---|
| 1 gambar mode standar (16:9) | 10880×6144 | 117 MB | Sekitar 2,5 menit |
| 4 / 9 gambar mode standar (1:1) | 8192×8192 | 100–130 MB | Sekitar 3 menit |
| Seri 4 gambar (3:4) | 7040×9344 | 77–104 MB | Sekitar 6 menit |
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
Bacadata.status melalui API kueri tugas: pending / processing berarti sedang diproses, completed berarti berhasil, dan failed memberikan detail di data.error.message.
curl --request GET \
--url 'https://api.apimart.ai/v1/tasks/task_example_kling_v4_image' \
--header 'Authorization: Bearer <token>'
data.result.images[].url[]; url berupa array. Ambil semua keluaran dan segera unduh untuk menyimpannya.
{
"code": 200,
"data": {
"id": "task_example_kling_v4_image",
"status": "completed",
"result": {
"images": [
{
"url": [
"https://example.com/generated-image.png"
]
}
]
}
}
}
Penagihan
Biaya dihitung berdasarkan jumlah gambar aktual dan tingkat resolusi yang dipilih. Gambar referensi ditagih terpisah per gambar. Lihat halaman harga untuk tarifnya.| Item tagihan | Kunci harga |
|---|---|
| Setiap gambar keluaran 2K | kling-v4-image@2K |
| Setiap gambar keluaran 4K | kling-v4-image@4K |
| Setiap gambar keluaran 8K | kling-v4-image@8K |
| Setiap gambar referensi masukan | kling-v4-image@input |
- Pembuatan standar dengan
n=3ditagih 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. Bacaerror.message untuk kesalahan pengiriman dan data.error.message untuk kegagalan setelah tugas dibuat.
| Cuplikan kesalahan | Penanganan |
|---|---|
`prompt` is required for kling-v4-image | Berikan prompt yang tidak kosong. |
`n` must be an integer between 1 and 9 | Gunakan bilangan bulat 1–9 untuk n. |
`n` cannot be combined with sequential_image_generation=auto | Dalam mode seri, hilangkan n atau atur ke 1; gunakan max_images untuk menentukan jumlah keluaran. |
`sequential_image_generation_options.max_images` is required for kling-v4-image series mode | Berikan max_images saat mengaktifkan seri. |
`sequential_image_generation_options.max_images` must be an integer between 2 and 4 | Gunakan bilangan bulat 2–4, bukan "auto". |
`resolution` must be 2K, 4K or 8K for kling-v4-image | Gunakan 2K, 4K, atau 8K; huruf besar/kecil tidak dibedakan. |
`size` must be auto or one of 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9 | Gunakan auto atau rasio yang didukung, bukan dimensi piksel. |
kling-v4-image supports at most 10 reference images | Berikan maksimal 10 gambar referensi. |
reference image is not accessible for kling-v4-image | URL referensi mengembalikan 403 / 404 / 410. Pastikan URL bersifat publik dan masih berlaku, atau unggah ulang gambar. |
unsupported reference image dimensions for kling-v4-image | Lebar dan tinggi masing-masing minimal 300 px, dengan rasio 2:5–5:2. Pelanggaran rasio memakai awalan kesalahan yang sama. |
reference image too large for kling-v4-image | Setiap referensi maksimal 30 MB. Kompres sebelum mengirim ulang. |
`n` must be an integer between 1 and 9 for kling-v4-image (got: "3") | Gunakan bilangan bulat JSON seperti "n": 3, bukan string "3". Kolom lain juga harus menggunakan tipe string, array, atau boolean yang dinyatakan. |