# Pembuat Gambar

Image Generator membuat gambar dari prompt teks di halaman Gallery atau dialog pemilih gambar dalam builder.

## Aturan tetap

| Pengaturan | Nilai |
| --- | --- |
| Jumlah hasil | 1 gambar |
| Ukuran | `1024x1024` |
| Biaya | 5 kredit per gambar |

Anda tidak memilih model, ukuran, resolusi, atau jumlah hasil. Biaya dan hasil sama saja, mau lewat dashboard maupun integrasi API.

## Alur di Gallery

1. Buka `Gallery` dan pilih workspace.
2. Isi prompt pada kartu Image Generator.
3. Klik **Generate Image**.
4. Task muncul di Task Tracker.
5. Saat selesai, Gallery menampilkan satu gambar baru.

Hasil otomatis masuk folder `ai-generated` dan tetap memakai kuota penyimpanan workspace.

## Alur di builder

Pada dialog **Pilih Gambar**, buka tab **Generate**:

1. isi prompt,
2. kirim task,
3. tunggu sampai statusnya selesai,
4. pilih gambar yang sudah masuk Gallery.

Dialog membatalkan permintaan lama saat ditutup atau saat workspace berubah, supaya hasil workspace sebelumnya tidak tercampur.

## Status task

- `submitted`: task sudah dicatat dan menunggu giliran,
- `processing`: gambar sedang dibuat,
- `completed`: gambar berhasil disimpan,
- `completed_with_warning`: gambar tersimpan dengan peringatan kecil,
- `failed`: proses gagal dan kredit dikembalikan,
- `cancelled`: task dibatalkan dan kredit dikembalikan.

Status `pending` hanya muncul di riwayat task lama. Task baru tidak memakainya.

## Kredit gambar

Kredit datang dari dua sumber: **jatah mingguan** dari paket workspace, dan **top-up** yang dibeli terpisah dan tidak ikut reset mingguan.

Kredit dikunci begitu Anda kirim task. Task yang sukses memakai kredit itu. Task yang gagal atau tertinggal dikembalikan kreditnya tanpa membuat gambar ulang.

Besar jatah mingguan tiap paket ada di halaman `/pricing`.

## Top-up

Owner atau admin workspace dapat membeli kredit dari kartu Top-Up Kredit Image:

1. pilih paket kredit,
2. lanjutkan ke checkout DOKU,
3. selesaikan pembayaran,
4. refresh halaman bila saldo belum berubah otomatis.

Saldo bertambah hanya setelah pembayaran terverifikasi. Riwayat pembayaran dan top-up tersimpan terpisah dari riwayat task.

## Jika task belum selesai

Image Generator bisa memakan waktu sekitar dua menit. Halaman mengecek status berkala, lalu berhenti setelah batas percobaan. Buka ulang Gallery untuk melihat status terbaru.

Jika task gagal, coba prompt yang lebih jelas. Jangan klik generate berulang kali dengan cepat. Biver mengenali permintaan yang sama, jadi kredit tidak terpotong dua kali.

## Lewat integrasi API

Agen dan integrasi lain bisa membuat gambar memakai kunci API workspace. Kunci harus punya izin Gallery. Task dan hasilnya selalu terikat ke workspace pemilik kunci. Lihat [REST API](/docs/rest-api) atau [Hubungkan ke Asisten AI](/docs/mcp-ai-assistant).