Pembuatan Gambar GPT-Image-2.5

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2.5-flare",
    "prompt": "sudut baca yang nyaman di dekat jendela saat hujan, cahaya lampu hangat",
    "size": "1:1",
    "resolution": "1k",
    "quality": "medium",
    "n": 1
  }'

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

{
  "error": {
    "code": 400,
    "message": "Parameter permintaan tidak valid",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": 401,
    "message": "Autentikasi gagal. Periksa kunci API Anda.",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "Saldo akun tidak mencukupi",
    "type": "payment_required"
  }
}

POST

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-2.5-flare",
    "prompt": "sudut baca yang nyaman di dekat jendela saat hujan, cahaya lampu hangat",
    "size": "1:1",
    "resolution": "1k",
    "quality": "medium",
    "n": 1
  }'

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

{
  "error": {
    "code": 400,
    "message": "Parameter permintaan tidak valid",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": 401,
    "message": "Autentikasi gagal. Periksa kunci API Anda.",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "Saldo akun tidak mencukupi",
    "type": "payment_required"
  }
}

Pemilihan model: gpt-image-2.5-flare lebih cepat dan cocok untuk gambar berkualitas tinggi sehari-hari, pembuatan massal, dan prototipe. gpt-image-2.5-sunburst mengutamakan ketepatan pengeditan untuk gambar produk final, materi iklan, dan pengeditan detail bertahap. Harga kedua model sama.

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2.5-flare",
    "prompt": "sudut baca yang nyaman di dekat jendela saat hujan, cahaya lampu hangat",
    "size": "1:1",
    "resolution": "1k",
    "quality": "medium",
    "n": 1
  }'

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

{
  "error": {
    "code": 400,
    "message": "Parameter permintaan tidak valid",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": 401,
    "message": "Autentikasi gagal. Periksa kunci API Anda.",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "Saldo akun tidak mencukupi",
    "type": "payment_required"
  }
}

Autentikasi

string

wajib

Semua endpoint menggunakan Bearer Token. Dapatkan kunci Anda di halaman kunci API.

Authorization: Bearer YOUR_API_KEY

Pilih model

Model	Kelebihan	Penggunaan yang disarankan
`gpt-image-2.5-flare`	Model default yang lebih cepat	Media sosial, produk, pencarian visual, prototipe, dan pembuatan massal
`gpt-image-2.5-sunburst`	Ketepatan pengeditan	Gambar produk final, materi iklan, dan pengeditan detail bertahap

Dengan parameter yang sama, penggunaan token dan harga kedua model identik. Dibandingkan gpt-image-2, GPT-Image-2.5 menambahkan xhigh dan max; tingkat medium dan high menggunakan sekitar seperempat token keluaran dari tingkat bernama sama pada generasi sebelumnya.

Parameter permintaan

string

wajib

gpt-image-2.5-flare atau gpt-image-2.5-sunburst.

string

wajib

Deskripsi gambar yang akan dibuat atau diedit. Jelaskan subjek, suasana, komposisi, gaya, pencahayaan, dan elemen yang perlu dipertahankan atau diubah.

string

default:"auto"

Rasio aspek atau ukuran piksel yang presisi.

auto: dipilih otomatis berdasarkan prompt atau gambar referensi
Rasio: 1:1, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, 2:1, 1:2, 21:9, 9:21, 3:1, 1:3
Ukuran presisi, misalnya 1600x1200

Untuk pengeditan gambar, abaikan size agar layanan menghitung ukuran dari rasio gambar input dan resolution.

string

default:"1k"

Tingkat resolusi: 1k, 2k, atau 4k. Diabaikan saat size berisi ukuran piksel presisi.

string

default:"auto"

Kualitas: low, medium, high, xhigh, max, atau auto.

xhigh dan max hanya tersedia untuk GPT-Image-2.5. Mengirimnya ke gpt-image-2 menghasilkan HTTP 400 tanpa penurunan kualitas otomatis.

integer

default:"1"

Jumlah gambar: 1 hingga 4. Kirim sebagai angka, bukan string.

string

default:"png"

Format keluaran: png, jpeg, atau webp.

integer

Kompresi dari 0 hingga 100, hanya untuk jpeg dan webp.

string

Latar belakang: transparent, opaque, atau auto.

transparent membutuhkan png atau webp; JPEG tidak memiliki kanal alfa.

string

default:"low"

Tingkat moderasi: auto atau low. Jika tidak dikirim, APIMart secara eksplisit mengirim low; nilai auto yang dikirim akan diteruskan.

string[]

URL gambar referensi untuk pembuatan atau pengeditan, maksimal 16. Mengirim bidang ini mengaktifkan mode pengeditan.Hanya URL HTTP(S) publik yang diterima. Unggah gambar lokal terlebih dahulu melalui POST /v1/uploads/images, lalu gunakan url yang dikembalikan.

Aturan ukuran

Lebar dan tinggi harus merupakan kelipatan 16
Setiap sisi tidak boleh melebihi 3840 piksel
Rasio sisi panjang terhadap sisi pendek maksimal 3:1
Jumlah piksel antara 655.360 dan 8.294.400

Resolusi di atas 2560×1440 bersifat eksperimental dan mungkin kurang stabil.

Pemetaan rasio dan resolusi

`size`	`1k`	`2k`	`4k`
`1:1`	1024×1024	2048×2048	2880×2880
`3:2`	1536×1024	2048×1360	3520×2336
`2:3`	1024×1536	1360×2048	2336×3520
`4:3`	1024×768	2048×1536	3312×2480
`3:4`	768×1024	1536×2048	2480×3312
`5:4`	1280×1024	2560×2048	3216×2576
`4:5`	1024×1280	2048×2560	2576×3216
`16:9`	1536×864	2048×1152	3840×2160
`9:16`	864×1536	1152×2048	2160×3840
`2:1`	2048×1024	2688×1344	3840×1920
`1:2`	1024×2048	1344×2688	1920×3840
`21:9`	2016×864	2688×1152	3840×1648
`9:21`	864×2016	1152×2688	1648×3840
`3:1`	1536×512	3072×1024	3840×1280
`1:3`	512×1536	1024×3072	1280×3840

Ukuran presisi lain dapat digunakan jika memenuhi semua aturan.

Contoh pengeditan

{
  "model": "gpt-image-2.5-sunburst",
  "prompt": "pertahankan produk dan teks kemasan, ubah latar menjadi studio putih lembut, lalu tambahkan bayangan alami",
  "image_urls": ["https://example.com/product.png"],
  "resolution": "2k",
  "quality": "xhigh"
}

Pengiriman dan kueri tugas

Setelah berhasil dikirim, ID tugas tersedia di data[0].task_id. Kueri status tugas setiap 2–5 detik hingga completed atau failed. Gunakan POST /v1/tasks/batch untuk beberapa tugas.

{
  "code": 200,
  "data": {
    "id": "task_01KXXXXXXXXXXXXXXX",
    "status": "completed",
    "progress": 100,
    "cost": 0.01325,
    "result": {
      "images": [{
        "url": ["https://upload.apimart.ai/f/image/example.png"],
        "expires_at": 1789000000
      }]
    },
    "usage": {
      "input_tokens": 16,
      "output_tokens": 439,
      "total_tokens": 455
    }
  }
}

URL gambar tersedia di data.result.images[].url[]. Unduh dan simpan file sesegera mungkin.

Status	Arti
`submitted`	Tugas dikirim
`processing`	Pembuatan berlangsung
`completed`	Berhasil; `result.images` tersedia
`failed`	Gagal; lihat `error.message`; dana reservasi dikembalikan

Penagihan

GPT-Image-2.5 ditagih berdasarkan pemakaian token aktual. Lihat halaman harga atau /api/pricing untuk harga akun saat ini.

Item	Harga per 1 juta token
Keluaran gambar	$30.00
Masukan gambar	$8.00
Masukan gambar dari cache	$2.00
Masukan teks	$5.00
Masukan teks dari cache	$1.25

`quality` pada 1024×1024	Token keluaran	Biaya keluaran resmi
`low`	196	$0.00588
`medium`	439	$0.01317
`high`	1756	$0.05268
`xhigh`	3122	$0.09366
`max`	7024	$0.21072

Dengan quality: "auto", layanan terlebih dahulu mereservasi biaya tingkat max untuk ukuran yang dipilih. Setelah selesai, biaya dihitung berdasarkan penggunaan aktual dan selisihnya dilepas.

Untuk n > 1, reservasi bertambah secara linear. Tugas yang gagal dikembalikan biayanya secara otomatis.

Batas dan kesalahan umum

Item	Batas atau solusi
Gambar per permintaan	1–4
Gambar referensi	Maksimal 16
Format keluaran	PNG / JPEG / WebP
Latar transparan	Hanya PNG / WebP
Streaming gambar parsial	Tidak didukung
Kualitas tidak valid	`xhigh` / `max` membutuhkan GPT-Image-2.5
Ukuran tidak valid	Gunakan kelipatan 16 dalam batas piksel dan rasio

Response

integer

Kode respons; 200 jika pengiriman berhasil.

array

Data respons pengiriman.

Tampilkan Item array

string

Status awal adalah submitted.

string

ID unik untuk mengkueri status dan hasil.

Ikhtisar

Model

Seri Teks

Seri Gambar

Seri Video

Seri Audio

Seri Moderasi

Manajemen Unggahan

Manajemen Tugas

Manajemen Akun

Pembuatan Gambar GPT-Image-2.5

Autentikasi

Pilih model

Parameter permintaan

Aturan ukuran

Pemetaan rasio dan resolusi

Contoh pengeditan

Pengiriman dan kueri tugas

Penagihan

Batas dan kesalahan umum

Response

​Autentikasi

​Pilih model

​Parameter permintaan

​Aturan ukuran

​Pemetaan rasio dan resolusi

​Contoh pengeditan

​Pengiriman dan kueri tugas

​Penagihan

​Batas dan kesalahan umum

​Response

Autentikasi

Pilih model

Parameter permintaan

Aturan ukuran

Pemetaan rasio dan resolusi

Contoh pengeditan

Pengiriman dan kueri tugas

Penagihan

Batas dan kesalahan umum

Response