gpt-image-2API

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

Contoh keluarangpt-image-2POST /v1/images/generations

Parameter: size=1536x1024n=1

Prompt: A 24-hour laundromat at three in the morning, a whole wall of front-loaders turning. A young man in a silver metallic bomber jacket has just tipped a jar of coloured glass marbles into the nearest drum. The marbles are pouring upward out of the open door instead of sinking, already arcing across the room in a bright teal and amber bridge that rings against the ceiling lights. Cold cyan tubes overhead, a hard warm amber glow thrown out of the drum itself. Straight-on symmetrical camera, wide, hyper-real detail in the glass, film grain, no text.

Permintaan yang menghasilkan sampel ini

{
  "model": "gpt-image-2",
  "prompt": "A 24-hour laundromat at three in the morning, a whole wall of front-loaders turning. A young man in a silver metallic bomber jacket has just tipped a jar of coloured glass marbles into the nearest drum. The marbles are pouring upward out of the open door instead of sinking, already arcing across the room in a bright teal and amber bridge that rings against the ceiling lights. Cold cyan tubes overhead, a hard warm amber glow thrown out of the drum itself. Straight-on symmetrical camera, wide, hyper-real detail in the glass, film grain, no text.",
  "n": 1,
  "size": "1536x1024"
}

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",
    "prompt": "A white cat runs through a neon-lit street in the rain",
    "size": "1024x1024", "n": 1
  }'

Minta catatan

Model gambar yang kompatibel dengan OpenAI menggunakan prompt, n, size, dan quality; gunakan pengeditan hanya ketika halaman resmi mendokumentasikannya.

Parameter permintaan

GPT Image menggunakan API Gambar yang kompatibel dengan OpenAI. Generasi menggunakan JSON; pengeditan dan pengeditan dengan panduan topeng menggunakan multibagian. GPT Image 2 mengembalikan data gambar Base64 di data[].b64_json.

Bidang	Wajib diisi	Catatan
model	Ya	gpt-image-2
prompt	Ya	Instruksi pembuatan atau pengeditan
size	Tidak	auto atau WIDTHxHEIGHT khusus dalam aturan ukuran yang terdokumentasi
quality	Tidak	low / medium / high / auto; bawaan auto
background	Tidak	auto / opaque / transparent; latar belakang transparan memerlukan keluaran PNG atau WebP
output_format	Tidak	png / jpeg / webp
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

Ukuran khusus mengharuskan kedua sisi memiliki kelipatan 16, rasio aspek 1:3 hingga 3:1, tepi maksimum 3.840 piksel, dan total piksel 655.360–8.294.400. Pengeditan menerima hingga 16 gambar sumber, masing-masing sumber dan topeng berukuran kurang dari 50 MB; jangan kirim DALL·E-only response_format.

Mengedit gambar

GPT Image 2 kali edit menggunakan /v1/images/edits dengan multibagian image/image[]; maksimal 16 gambar masukan diterima, dan topeng harus sesuai dengan format dan dimensi gambar pertama.

bash

curl https://modelflare.dev/v1/images/edits \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -F "model=gpt-image-2" \
  -F "image[]=@/path/to/product.png" \
  -F "mask=@/path/to/mask.png" \
  -F "prompt=保持主体不变，将背景替换为暖色摄影棚渐变" \
  -F "size=1536x1024" \
  -F "quality=high" \
  -F "output_format=png" \
  -F "n=1"

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.