Langsung ke konten utama
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": "gemini-3.1-flash-image-preview",
    "prompt": "Cyberpunk cityscape at night with neon lights",
    "size": "16:9",
    "resolution": "2K",
    "n": 1
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

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.

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-3.1-flash-image-preview",
    "prompt": "Cyberpunk cityscape at night with neon lights",
    "size": "16:9",
    "resolution": "2K",
    "n": 1
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

​
Otorisasi

​
Authorization
string
wajib
Semua endpoint API memerlukan autentikasi Bearer TokenDapatkan API Key Anda:Kunjungi Halaman Manajemen API Key untuk mendapatkan API Key AndaTambahkan ke header permintaan:
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
default:"gemini-3.1-flash-image-preview"
wajib
Nama model pembuatan gambarModel yang didukung:
  • gemini-3.1-flash-image-preview - Versi standar
  • gemini-3.1-flash-image-preview-official - Versi resmi
Contoh: "gemini-3.1-flash-image-preview" atau "gemini-3.1-flash-image-preview-official"
​
prompt
string
wajib
Deskripsi teks untuk pembuatan gambar
​
size
string
Rasio aspek gambarRasio yang didukung:
  • auto - Memilih rasio aspek secara otomatis
  • 1:1 - Persegi, avatars, social media
  • 3:2 / 2:3 - Foto standar
  • 4:3 / 3:4 - Rasio tampilan tradisional
  • 16:9 / 9:16 - Layar lebar / vertical video covers
  • 5:4 / 4:5 - Instagram images
  • 21:9 - Ultra-lebar banner
  • 1:4 / 4:1 - Long poster / banner
  • 1:8 / 8:1 - Extreme long images / banner ads
Untuk text-to-image, saat size bernilai auto, default-nya adalah 1:1 atau 16:9; untuk image-to-image, rasio aspek mengikuti respons upstream. Kami menyarankan untuk menentukan rasio aspek.
​
resolution
string
default:"1K"
Resolusi gambar outputNilai yang didukung:
  • 0.5K - ~512px, pratinjau resolusi rendah
  • 1K - ~1024px, resolusi standar (default)
  • 2K - ~2048px, resolusi tinggi
  • 4K - ~4096px, ultra-resolusi tinggi
Catatan: Resolusi berbeda memiliki harga berbeda. 4K lebih mahal daripada 1K.
​
n
integer
Jumlah gambar yang akan dibuatRentang: 1-4 (minimum 1, maksimum 4)Default: 1⚠️ Catatan: Harus memasukkan angka biasa (misalnya 1), jangan gunakan tanda kutip karena akan menyebabkan error
​
official_fallback
boolean
default:"false"
Apakah akan menggunakan fallback kanal resmi
  • false: Jangan gunakan (default)
  • true: Gunakan kanal resmi
Saat menggunakan kanal resmi (gemini-3.1-flash-image-preview-official), parameter ini tidak dapat digunakan.
​
image_urls
array
Daftar URL gambar referensi untuk pembuatan image-to-imageDua format didukung:1. URL gambar lengkap
  • URL gambar yang dapat diakses publik (http:// atau https://)
  • Contoh: https://example.com/image.jpg
2. Format berenkode Base64
  • Harus menggunakan format Data URI lengkap
  • Format: data:image/{format};base64,{base64data}
  • Format gambar yang didukung: jpeg, png, webp
  • Contoh: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  • ⚠️ Catatan: Harus menyertakan prefiks data:image/jpeg;base64,
Batasan:
  • Maksimum 14 gambar referensi (disarankan: hingga 10 referensi objek + 4 referensi karakter)
  • Ukuran satu gambar: tidak melebihi 10MB
  • Format yang didukung: jpeg, png, webp
​
google_search
boolean
default:"false"
Aktifkan Google text search enhancement
  • true: Model akan mencari informasi teks web untuk membantu pembuatan gambar, cocok untuk skenario yang membutuhkan informasi dunia nyata
  • false: Dinonaktifkan (default)
​
google_image_search
boolean
default:"false"
Aktifkan peningkatan pencarian gambar Google
  • true: Selain pencarian teks, sistem juga akan mencari gambar referensi untuk membantu pembuatan, cocok untuk skenario yang membutuhkan referensi visual
  • false: Dinonaktifkan (default)
Catatan: Harus digunakan bersama google_search: true

​
Respons

​
code
integer
Kode status respons
​
data
array
Array data respons