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-pro-image-preview",
    "prompt": "A bamboo forest path under moonlight",
    "size": "1:1",
    "n": 1,
    "resolution": "1K"
  }'

{
  "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-pro-image-preview",
    "prompt": "A bamboo forest path under moonlight",
    "size": "1:1",
    "n": 1,
    "resolution": "1K"
  }'

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

​
Otorisasi

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

​
Body

​
model
string
default:"gemini-3-pro-image-preview"
wajib
Nama model pembuatan gambarModel yang didukung:
  • gemini-3-pro-image-preview - Versi standar
  • gemini-3-pro-image-preview-official - Versi resmi
Contoh: "gemini-3-pro-image-preview" atau "gemini-3-pro-image-preview-official"
​
prompt
string
wajib
Deskripsi teks untuk pembuatan gambar
​
size
string
Ukuran pembuatan gambarFormat yang didukung:
  • Rasios: auto, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
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.
​
n
integer
Jumlah gambar yang akan dibuatRentang: 1-4 (minimum 1, maksimum 4)Default: 1⚠️ Catatan: Harus berupa angka murni (misalnya 1), jangan tambahkan tanda kutip, jika tidak akan terjadi error
​
resolution
string
Resolusi gambar outputNilai yang didukung:
  • 1K - Resolusi 1K (default)
  • 2K - Resolusi 2K
  • 4K - Resolusi 4K
⚠️ Catatan: Pembuatan gambar 4K dengan format base64 membutuhkan waktu pemrosesan lebih lama
​
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-pro-image-preview-official), parameter ini tidak dapat digunakan.
​
image_urls
array
Daftar URL gambar referensi untuk image-to-image atau pengeditan gambar💡 Isi Cepat (area Try it):
  1. Klik ”+ Add an item” untuk menambahkan URL gambar
  2. Masukkan alamat URL gambar lengkap atau data base64
Batas: Maksimum 14 images

​
Respons

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