POST /v1/images/generations
Referensi · Images — endpoint yang kompatibel dengan OpenAI Images untuk pembuatan gambar terjaga. Prompt melewati moderasi konten + NSFW sebelum mencapai model gambar.
Ikhtisar
Pembuatan gambar terjaga
POST /v1/images/generations kompatibel dengan OpenAI Images dan menggunakan API key Anda (auth Bearer). Setiap prompt melewati penjaga media bersama (keselamatan anak, ekstremisme kekerasan, NSFW, moderasi konten; Inggris + Bahasa Indonesia) sebelum mencapai model gambar, data pribadi yang tervalidasi disamarkan, dan setiap gambar dihargai sebesar harga penyedia ditambah margin kami, dipotong dari saldo prabayar Anda. Gambar dibuat oleh fal.ai, di luar Indonesia.
Halaman ini adalah referensi request/response ringkas. Untuk panduan lengkap — enhance, style, UI studio, dan biaya — lihat panduan Image generation.
Request
Body request
Kirim body JSON dengan prompt dan opsi pembuatan:
| Field | Deskripsi |
|---|---|
model | flux-schnell (default, Fast, Rp 71/gambar), flux-1.1-pro atau recraft-v3 (Quality, Rp 924/gambar), flux-1.1-pro-ultra (Rp 1.386) atau ideogram-v3 (Rp 1.386) (Premium). Harga terkini ada di halaman model. Paket Anda menentukan model yang bisa dipakai (jika tidak, 403 image_model_not_entitled). Nilai lain mengembalikan 400. |
prompt | Teks prompt. Wajib. |
n | Jumlah gambar, 1–4. Default 1. |
enhance | Jika true, art-director LLM murah menulis ulang prompt untuk kualitas dan membuang 'AI slop'. Guard berjalan ulang pada prompt yang di-enhance sebelum model gambar. |
style | Preset opsional yang mengarahkan tampilan: product-photo, editorial, flat-illustration, 3d-render, cinematic. |
response_format | Kirim b64_json untuk menerima gambar base64 inline. Jika tidak, response mengembalikan URL penyedia yang bersifat sementara. |
Batas & guard
Yang diberlakukan
- Batas harian. 100 gambar per API key per hari. Paket Free: 5 gambar Fast/hari, maks. 50/bulan, gratis dengan email terverifikasi, selama anggaran Free bulanan untuk gambar masih tersedia.
- Timeout. 45 detik per pembuatan.
- Penjaga media. Berjalan pada prompt (dan pada prompt yang di-enhance saat enhance aktif). Prompt yang diblokir tidak pernah mencapai model dan tidak dikenai biaya.
- Gerbang paket. Model di atas paket Anda mengembalikan
403 image_model_not_entitled. - Model tak dikenal. Model apa pun di luar allowlist mengembalikan
400.
Response
Body response
Setiap item membawa data[].b64_json (saat response_format adalah b64_json) atau data[].url (sementara). revised_prompt mencerminkan prompt final yang benar-benar dikirim ke model, dan _anoman.enhanced_prompt menampilkan hasil tulis ulang prompt oleh art-director.
Berkreasi di studio.
Komposer prompt, style, pemilih model sesuai paket, palet — semua terjaga.