> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

```bash cURL theme={null}
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
}'
```

```python Python theme={null}
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())
```

```javascript JavaScript theme={null}
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());
```

```json 200 theme={null}
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_example_kling_v4_image"
    }
  ]
}
```

```json 400 theme={null}
{
  "error": {
    "code": 400,
    "message": "`prompt` is required for kling-v4-image",
    "type": "invalid_request_error"
  }
}
```

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

**Authorization** `string` *required*

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

## Parameter permintaan

**model** `string` *required*

Harus `kling-v4-image`.

**nsfw\_check** `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)

**prompt** `string` *required*

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.

**image\_urls** `string[]`

Hingga 10 gambar referensi berupa URL gambar langsung yang dapat diakses publik. Untuk file lokal, gunakan [API unggah gambar](https://docs.apimart.ai/id/api-reference/uploads/images.md), 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.

**n** `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.

**resolution** `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.

**size** `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.

**aspect\_ratio** `string`

Alias untuk `size` dengan nilai yang sama. Jika keduanya dikirim, `aspect_ratio` diprioritaskan.

**sequential\_image\_generation** `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.

**sequential\_image\_generation\_options** `object`

Menentukan jumlah gambar dalam mode seri.

**Properti**

**max\_images** `integer`

Wajib dalam mode seri: bilangan bulat 2–4 untuk menentukan jumlah keluaran. Nilai yang tidak dikirim, string `"auto"`, atau nilai di luar rentang menghasilkan HTTP 400.

> [!WARNING]
>
> `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

```bash theme={null}
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

```bash theme={null}
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

```bash theme={null}
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

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.

```bash theme={null}
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 |

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](https://docs.apimart.ai/id/api-reference/tasks/status.md): `pending` / `processing` berarti sedang diproses, `completed` berarti berhasil, dan `failed` memberikan detail di `data.error.message`.

```bash theme={null}
curl --request GET \
  --url 'https://api.apimart.ai/v1/tasks/task_example_kling_v4_image' \
  --header 'Authorization: Bearer <token>'
```

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.

```json theme={null}
{
  "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](https://apimart.ai/pricing) 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=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.

| 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. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.