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": "gpt-image-1-official",
    "prompt": "An ancient castle under a starry sky",
    "size": "1:1",
    "quality": "auto",
    "n": 1
  }'

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

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": "gpt-image-1-official",
    "prompt": "An ancient castle under a starry sky",
    "size": "1:1",
    "quality": "auto",
    "n": 1
  }'

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

​
Model yang Didukung

ModelDeskripsiModeImage-to-ImageGambar MaksPenagihan
gpt-image-1-officialMengutamakan stabilitas, cocok untuk pembuatan gambar umumText-to-Image / Image-to-ImageDidukung4Ukuran x Kualitas
gpt-image-1.5-officialVersi baru, cocok untuk kualitas lebih tinggi dan pengeditan kompleksText-to-Image / Image-to-ImageDidukung4Ukuran x Kualitas

​
Otorisasi

​
Authorization
string
wajib
Semua permintaan API memerlukan autentikasi Bearer TokenDapatkan API Key Anda:Kunjungi halaman manajemen API Key untuk memperoleh API Key AndaTambahkan berikut ini ke header permintaan Anda:
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
wajib
Nama model
  • gpt-image-1-official - Mengutamakan stabilitas, cocok untuk pembuatan gambar umum
  • gpt-image-1.5-official - Versi baru, cocok untuk kualitas lebih tinggi dan pengeditan kompleks
​
prompt
string
wajib
Deskripsi teks untuk pembuatan gambar, mendukung bahasa Mandarin dan Inggris
​
size
string
default:"1:1"
Rasio aspekRasio yang didukung:
  • 1:1 - Persegi (default)
  • 3:2 - Lanskap
  • 2:3 - Potret
​
n
integer
default:"1"
Jumlah gambar yang akan dibuatRentang: 1-4
  • Values ≤ 0 will be treated as 1
  • Values > 4 will be treated as 4
Peringatan: Harus berupa angka biasa (misalnya 1), jangan tambahkan tanda kutip, jika tidak akan menyebabkan error
​
quality
string
default:"auto"
Kualitas gambar
  • auto - Pemilihan kualitas otomatis (default)
  • low - Faster, more economical
  • medium - Keseimbangan antara kualitas dan biaya
  • high - Kualitas lebih tinggi, biaya lebih tinggi
​
background
string
default:"auto"
Mode latar belakang
  • auto - Latar belakang otomatis (default)
  • opaque - Opaque background
  • transparent - Latar belakang transparan, direkomendasikan dengan format output png
background: transparent tidak dapat digunakan dengan output_format: jpeg secara bersamaan
​
moderation
string
default:"auto"
Moderation level
  • auto - Level moderasi default
  • low - Moderasi lebih longgar
​
output_format
string
default:"png"
Format output
  • png - Format default, cocok untuk latar belakang transparan
  • jpeg - Ukuran file lebih kecil, cocok untuk output gambar umum
background: transparent tidak dapat digunakan dengan output_format: jpeg secara bersamaan
​
output_compression
integer
Level kompresi output, range 0-100
  • Direkomendasikan hanya untuk jpeg
  • Tidak direkomendasikan untuk png
​
image_urls
array
Array URL gambar referensi; mengaktifkan mode image-to-image saat disediakanBatas: Hingga 15 gambar referensi
​
mask_url
string
URL gambar mask untuk inpainting
  • Harus digunakan bersama image_urls
  • Akan dikirim melalui API pengeditan resmi
  1. Sebelum mengunggah gambar mask, pastikan kanal Alpha gambar bernilai “Yes”.
  2. Ukuran gambar mask harus cocok dengan gambar referensi pertama.

​
Referensi Ukuran

Rasio aspek digunakan secara eksternal; sistem otomatis memetakannya ke dimensi resmi secara internal.
RasioActual UkuranDeskripsi
1:11024x1024Persegi
2:31024x1536Potret
3:21536x1024Lanskap

​
Contoh Penggunaan

Text-to-Image (minimal) 
{
  "model": "gpt-image-1-official",
  "prompt": "An ancient castle under a starry sky"
}
Text-to-Image (parameter lengkap) 
{
  "model": "gpt-image-1-official",
  "prompt": "A flat icon of a glass bottle with no background",
  "size": "2:3",
  "quality": "high",
  "background": "transparent",
  "moderation": "low",
  "output_format": "png",
  "n": 1
}
Image-to-Image (referensi tunggal) 
{
  "model": "gpt-image-1.5-official",
  "prompt": "Convert the reference image to illustration style, preserving the main outline",
  "size": "1:1",
  "quality": "auto",
  "image_urls": [
    "https://your-cdn.com/input.png"
  ],
  "n": 1
}
Image-to-Image (fusi multi-referensi) 
{
  "model": "gpt-image-1.5-official",
  "prompt": "Merge two reference images into an illustration poster, preserving the main outlines",
  "size": "1:1",
  "quality": "auto",
  "background": "transparent",
  "image_urls": [
    "https://your-cdn.com/input-a.png",
    "https://your-cdn.com/input-b.png"
  ],
  "moderation": "low",
  "output_format": "png",
  "n": 1
}
Beberapa gambar (n > 1) 
{
  "model": "gpt-image-1-official",
  "prompt": "Four minimalist poster variations of a red fox",
  "size": "1:1",
  "quality": "low",
  "output_format": "png",
  "n": 4
}

​
Respons

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

​
Catatan

  1. Pemrosesan asinkron: Setelah pengiriman, task_id dikembalikan. Polling /v1/tasks/{task_id} untuk mendapatkan hasil
  2. Pemilihan model: Gunakan gpt-image-1-official untuk pembuatan gambar umum; gunakan gpt-image-1.5-official untuk pengeditan berkualitas tinggi dan tugas image-to-image yang kompleks
  3. Persyaratan URL gambar: Untuk image-to-image, gunakan URL gambar yang dapat diakses publik dan stabil
  4. Penagihan: Ditagih per gambar yang berhasil dibuat; tidak ada biaya untuk kegagalan