gpt-image-2.5-flareAPI

Gunakan ID model yang tepat gpt-image-2.5-flare. Bidang model harus sama persis dengan halaman ini.

Contoh keluarangpt-image-2.5-flarePOST /v1/images/generations

Parameter: size=1536x1024quality=mediumn=1

Prompt: Children's picture-book illustration: a small fox carrying a paper lantern through a snowy birch forest at dusk, soft gouache textures, gentle blues and warm orange glow, friendly and calm, no text.

Permintaan yang menghasilkan sampel ini

{
  "model": "gpt-image-2.5-flare",
  "prompt": "Children's picture-book illustration: a small fox carrying a paper lantern through a snowy birch forest at dusk, soft gouache textures, gentle blues and warm orange glow, friendly and calm, no text.",
  "n": 1,
  "size": "1536x1024",
  "quality": "medium"
}

Otentikasi dan titik akhir

Gunakan kunci API Modelflare dengan https://modelflare.dev/v1. Titik masuk gateway adalah POST /v1/images/generations.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Menghasilkan gambar

bash

curl https://modelflare.dev/v1/images/generations \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-flare",
    "prompt": "A white cat runs through a neon-lit street in the rain",
    "size": "1536x1024", "quality": "high", "background": "opaque", "output_format": "jpeg",
    "output_compression": 85, "moderation": "auto", "n": 1
  }'

Minta catatan

GPT Image 2.5 Flare adalah default yang cepat dan berkualitas tinggi untuk pembuatan dan pengeditan sehari-hari; pertahankan images[], image[], mask, dan kontrol keluaran lengkap.

Parameter permintaan

GPT Image 2.5 menggunakan API Gambar yang kompatibel dengan OpenAI. Generasi menggunakan JSON; pengeditan menerima referensi gambar JSON atau file multi-bagian; tanggapan mengembalikan data gambar Base64 di data[].b64_json.

Bidang	Wajib diisi	Catatan
model	Ya	gpt-image-2.5-flare
prompt	Ya	Instruksi pembuatan atau pengeditan, 1–32.000 karakter
images[]	Bersyarat	Untuk pengeditan JSON, hingga 16 objek file_id atau image_url.
images[].file_id	Bersyarat	ID API File yang Diunggah
images[].image_url	Bersyarat	URL gambar atau URL data Base64; URL data dibatasi hingga 20.971.520 karakter
image	Bersyarat	Satu file sumber multi bagian; gunakan image[] untuk banyak file
image[]	Bersyarat	Untuk pengeditan multibagian, hingga 16 file sumber
mask	Tidak	Masker alfa cocok dengan format/ukuran sumber pertama dan di bawah 50 MB
size	Tidak	auto atau kustom WIDTHxHEIGHT; Kelipatan 16 piksel, rasio aspek 1:3–3:1, tepi maksimal 3.840 piksel, dan total piksel 655.360–8.294.400
quality	Tidak	low / medium / high / xhigh / max / auto; bawaan auto
background	Tidak	auto / opaque / transparent; latar belakang transparan memerlukan keluaran PNG atau WebP
output_format	Tidak	png / jpeg / webp; bawaan png
output_compression	Tidak	0–100 untuk JPEG/WebP, default 100; diabaikan untuk PNG
moderation	Tidak	auto / low; bawaan auto
n	Tidak	1–10 keluaran; bawaan 1

Batas respons dan masukan

GPT Image 2.5 Flare dan Sunburst mendukung hingga 16 input edit. Pengeditan JSON menggunakan images[] dengan file_id atau image_url; pengeditan multibagian menggunakan image/image[], dengan masing-masing gambar sumber dan mask di bawah 50 MB. Perintahnya terdiri dari 1–32.000 karakter; kualitas mendukung low/medium/high/xhigh/max/auto; aturan ukurannya adalah kelipatan 16 piksel, rasio aspek 1:3–3:1, tepi maksimal 3.840 piksel, dan total piksel 655.360–8.294.400. Latar belakang transparan memerlukan PNG atau WebP; kompresi hanya berlaku untuk JPEG/WebP dan diabaikan untuk PNG. Resolusi di atas 2560x1440 bersifat eksperimental. Baca data[].b64_json; jangan kirim DALL·E saja response_format. Flare adalah default yang cepat dan berkualitas tinggi untuk pembuatan dan pengeditan sehari-hari; Sunburst ditujukan untuk pekerjaan dengan ketelitian lebih tinggi dan kontrol lebih tinggi.

Mengedit gambar

GPT Image 2.5 mendukung referensi gambar JSON dan unggahan file multibagian melalui /v1/images/edits. JSON menerima hingga 16 objek menggunakan file_id atau image_url; multipart menerima hingga 16 file sumber. Jangan mencampur images dengan image/image[] dalam satu permintaan.

bash

curl https://modelflare.dev/v1/images/edits \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-flare",
    "images": [{"file_id": "file-example123"}, {"image_url": "https://example.com/reference.png"}],
    "prompt": "Keep the product unchanged and replace the background with a warm studio gradient",
    "size": "1536x1024", "quality": "high", "background": "opaque", "output_format": "png", "n": 1
  }'

bash

curl https://modelflare.dev/v1/images/edits \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -F "model=gpt-image-2.5-flare" \
  -F "image[]=@/path/to/product.png" \
  -F "mask=@/path/to/mask.png" \
  -F "prompt=Keep the product unchanged and replace the background with a warm studio gradient" \
  -F "size=1536x1024" \
  -F "quality=high" \
  -F "background=opaque" \
  -F "output_format=png" \
  -F "n=1"

Bentuk respons

Membaca hasil yang dihasilkan dan diedit dari data[]. GPT Image 2.5 mengembalikan data gambar Base64; jangan perlakukan respons sebagai keluaran URL.

Bidang	Catatan
created	Waktu pembuatan sebagai stempel waktu Unix dalam hitungan detik
data	Hasil gambar yang dihasilkan atau diedit
data[].b64_json	Data gambar berkode Base64
background	Mode latar belakang terakhir: opaque atau transparent
output_format	Format gambar yang dikembalikan: png, jpeg, atau webp
quality	Tingkat kualitas digunakan
size	Dimensi akhir sebagai WIDTHxHEIGHT

Kesalahan dan tugas yang gagal

Parameter model yang tidak valid mengembalikan 4xx dengan ID permintaan; gunakan bidang respons dan pesan kesalahan yang ditentukan oleh kontrak model yang dipilih.

Cakupan yang didukung

Halaman ini mencakup pembuatan model Modelflare dan panggilan pengeditan. Pengayaan penelusuran atau peta, pengelolaan suara, dan pengelolaan pustaka elemen merupakan API sumber daya di luar permukaan panggilan model publik ini dan bukan merupakan bidang permintaan yang wajib diisi.

Pricing and billing

Model ini menggunakan penagihan berbasis token. Lihat halaman harga model untuk harga pelanggan saat ini, harga daftar referensi, dan spesifikasi lengkap.

Catatan

Halaman ini mendokumentasikan antarmuka publik Modelflare; bidang dan batasan yang ditampilkan di sini adalah kontrak saat ini.