GPT Image 2 API melalui Flatkey sebaiknya dimulai dengan pemeriksaan baris model, bukan menyalin blok kode. OpenAI mendokumentasikan gpt-image-2 sebagai model generasi gambar saat ini, dan snapshot harga Flatkey tanggal 17 Juni 2026 mencantumkan baris keluarga GPT image. Pertanyaan yang berguna bagi tim produksi lebih sempit: baris mana yang akan dipanggil aplikasi Anda, bentuk endpoint apa yang diekspos baris itu, unit harga apa yang harus ditinjau finance, dan pemeriksaan permintaan apa yang harus lolos sebelum trafik melewati router?
Panduan ini membahas pemeriksaan tersebut untuk tim yang menginginkan satu kunci Flatkey, base URL yang kompatibel dengan OpenAI https://router.flatkey.ai/v1, log penggunaan, dan peninjauan harga di satu tempat. Perlakukan setiap contoh kode di bawah sebagai templat. Artikel ini menggunakan dokumentasi resmi OpenAI, snapshot katalog Flatkey bertanggal, dan pemeriksaan CMS/rute publik, tetapi tidak mengklaim bahwa tes inferensi GPT Image 2 API langsung pada Flatkey telah dijalankan.
Jawaban Singkat: Apa yang Harus Diverifikasi Sebelum Menggunakan GPT Image 2 API Melalui Flatkey
Jika Anda mengevaluasi GPT Image 2 API melalui Flatkey, verifikasi item berikut dalam urutan ini:
- Buka harga Flatkey dan cari baris model yang tepat, seperti
gpt-image-2atauopenai/gpt-image-2. - Konfirmasi jenis endpoint yang didukung untuk baris tersebut. Dalam snapshot 17 Juni 2026, baris utama
gpt-image-2mengeksposopenai, sementara baris GPT image yang lebih lama juga mengeksposimage-generation. - Periksa status ketersediaan. Baris GPT Image 2 dalam snapshot menunjukkan
unknown_failure, jadi penggunaan produksi memerlukan pemeriksaan dashboard terkini dan uji smoke kecil. - Bandingkan unit harga sebelum peluncuran. Flatkey menunjukkan field bergaya rasio token untuk satu baris dan field
model_priceyang tampak berbasis harga per permintaan untuk baris lain, jadi jangan berasumsi satu unit untuk setiap rute GPT Image 2 API. - Cocokkan body permintaan Anda dengan rute yang dikonfirmasi: gaya Images API, gaya Responses API, atau pembungkus yang kompatibel dengan OpenAI yang didukung Flatkey.
- Catat model ID, path endpoint, kualitas, ukuran output, format output, jumlah gambar input, jumlah retry, penggunaan, dan biaya akhir per aset yang diterima.
Urutan itu penting karena GPT Image 2 API bukan sekadar nama model. Ini adalah kombinasi dari ID model, endpoint, parameter permintaan, entitlement akun, status routing, dan unit penagihan.
Apa yang Didokumentasikan OpenAI Untuk GPT Image 2 API
Panduan gambar OpenAI mengatakan bahwa model GPT Image dapat menggunakan input teks dan gambar untuk membuat gambar baru atau mengedit yang sudah ada, dan mendeskripsikan gpt-image-2 sebagai model generasi gambar mutakhir dengan kepatuhan instruksi dan kesadaran kontekstual yang kuat. Panduan itu juga menyebutkan bahwa tim dapat membuat atau mengedit gambar dengan Images API atau Responses API.
Untuk jalur Images API, referensi create-image mendokumentasikan POST /images/generations. Ini mencakup parameter yang penting untuk pemeriksaan permintaan produksi: prompt, background, moderation, output_format, quality, size, stream, dan n. Referensi itu juga menyatakan bahwa model GPT image mengembalikan gambar yang dienkode base64, bukan URL gambar sementara.
| Pemeriksaan OpenAI | Mengapa Ini Penting Untuk Flatkey | Tindakan Produksi |
|---|---|---|
model |
ID model OpenAI langsung mungkin tidak sama string-nya dengan baris katalog yang dirutekan. | Catat baris Flatkey yang tepat dan string model di permintaan Anda. |
POST /images/generations |
Ini adalah jalur pembuatan Images API resmi, tetapi dukungan endpoint Flatkey bergantung pada baris. | Gunakan rute ini melalui Flatkey hanya setelah dashboard menunjukkan dukungan Images API untuk baris yang dipilih. |
background dan output_format |
Output transparan memerlukan format yang kompatibel seperti PNG atau WebP. | Validasi format output sebelum membuat alur kerja desain yang bergantung pada alpha. |
quality dan size |
Ini adalah pengungkit utama biaya dan latensi untuk beban kerja GPT Image 2 API. | Pisahkan pengaturan draft, pratinjau, dan render final dalam logika produk. |
| Penanganan respons Base64 | Model GPT image mengembalikan byte gambar, bukan URL yang di-hosting jangka panjang. | Simpan gambar sendiri, lampirkan metadata, dan jangan bergantung pada URL penyedia. |
Snapshot Katalog Flatkey Untuk GPT Image 2
Pada 17 Juni 2026, API harga publik Flatkey mengembalikan versi harga a42d372ccf0b5dd13ecf71203521f9d2 dan 638 baris model. Ringkasan keluarga GPT image mencakup gpt-image-2, openai/gpt-image-2, gpt-image-2-all, gpt-image-1.5, gpt-image-1-mini, dan gpt-image-1.
| Baris Flatkey | Grup | Jenis Endpoint Dalam Snapshot | Field Harga yang Terlihat | Status Dalam Snapshot | Cara Menggunakan Bukti Ini |
|---|---|---|---|---|---|
gpt-image-2 |
Economy, Standard | openai |
model_ratio: 3.325, completion_ratio: 6, cache_ratio: 0.251127819549 |
unknown_failure |
Gunakan hanya sebagai bukti katalog bertanggal; verifikasi status baris saat ini sebelum traffic GPT Image 2 API produksi. |
openai/gpt-image-2 |
Standard | openai |
quota_type: 1, model_price: 0.063 |
unknown_failure |
Jangan menyalin angka tanpa mengonfirmasi unit dan label dasbor saat ini. |
gpt-image-2-all |
Standard | openai |
model_ratio: 37.5, completion_ratio: 2 |
unknown_failure |
Periksa apakah ini bundle, alias, atau baris routing internal sebelum menggunakannya dalam kode. |
gpt-image-1.5 and gpt-image-1-mini |
Standard | image-generation, openai |
Field harga bergaya rasio | unknown_failure |
Baris pembanding yang berguna, tetapi bukan pengganti baris GPT Image 2 API yang dipilih. |
Halaman harga publik juga menampilkan keluarga endpoint seperti image-generation dengan path /v1/images/generations, openai dengan path /v1/chat/completions, dan openai-response dengan path /v1/responses. Detail pentingnya adalah bahwa keluarga endpoint ada di level platform, sementara dukungan tetap spesifik per baris. Untuk GPT Image 2 API, konfirmasikan barisnya sebelum menulis permintaan.
Pemeriksaan Permintaan Untuk GPT Image 2 API
Gunakan daftar periksa ini sebelum peluncuran GPT Image 2 API apa pun yang dirutekan. Ini sengaja bersifat operasional karena kesalahan harga biasanya berasal dari bentuk permintaan, bukan dari salah paham terhadap satu tarif utama.
| Pemeriksaan | Condition Lulus | Mode Kegagalan | Tempat Memverifikasi |
|---|---|---|---|
| Baris model | Baris dasbor Flatkey cocok dengan string model di kode. | Aplikasi secara tidak sengaja memanggil baris legacy, alias, atau bundle. | Pricing dan katalog model Flatkey. |
| Path endpoint | Path rute cocok dengan jenis endpoint yang didukung baris tersebut. | Body Images API dikirim ke baris yang kompatibel dengan chat, atau sebaliknya. | Dukungan baris Flatkey plus referensi API OpenAI. |
| Ketersediaan | Status dasbor bersih, dan permintaan kecil berhasil. | Baris katalog ada tetapi akses upstream atau akun gagal. | Dasbor Flatkey, status respons, dan log. |
| Unit harga | Tim finance mengetahui apakah baris tersebut token-ratio, berharga per permintaan, atau unit lain. | Anggaran menggunakan asumsi per-token untuk baris per-requests. | Harga Flatkey dan dasbor penggunaan. |
| Prompt dan input gambar | Panjang prompt, referensi gambar, mask, dan percobaan ulang dicatat. | Gambar input dan percobaan ulang menciptakan biaya tersembunyi. | Telemetri aplikasi dan field penggunaan penyedia. |
| Pengaturan output | Kualitas, ukuran, latar belakang, format, dan kompresi dikendalikan. | Setiap pratinjau dihasilkan sebagai aset final. | Body permintaan dan default produk. |
Template: Permintaan Direct OpenAI Images API
Template penyedia langsung berguna sebagai baseline saat membandingkan perilaku rute Flatkey. Konfirmasikan akses akun OpenAI dan ketersediaan model saat ini sebelum menjalankannya.
# Template only: baseline direct OpenAI Images API
curl https://api.openai.com/v1/images/generations \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "Create a clean product concept image for a usage dashboard.",
"size": "1536x1024",
"quality": "medium",
"output_format": "png"
}'
Untuk pengujian baseline GPT Image 2 API, buat prompt pertama tetap sederhana, hindari gambar referensi, gunakan satu output, dan catat status respons, latensi, ukuran output, serta field penggunaan apa pun yang dikembalikan oleh endpoint.
Template: Pemeriksaan Rute Flatkey
Posisi publik Flatkey berpusat pada satu kunci dan base URL yang kompatibel dengan OpenAI. Untuk rute teks, beranda publik menampilkan https://router.flatkey.ai/v1/chat/completions. Untuk routing GPT Image 2 API, jangan berasumsi path gambar diaktifkan untuk baris yang dipilih. Pertama periksa apakah baris tersebut mengekspos image-generation, openai, openai-response, atau rute lain di dasbor Anda.
# Template only: gunakan bentuk ini hanya jika baris Flatkey Anda mengonfirmasi dukungan pembuatan gambar
curl https://router.flatkey.ai/v1/images/generations \
-H "Authorization: Bearer $FLATKEY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "Buat gambar konsep produk yang bersih untuk dashboard penggunaan.",
"size": "1536x1024",
"quality": "medium",
"output_format": "png"
}'
// Template only: pusatkan base URL, lalu injeksikan path yang telah dikonfirmasi.
const FLATKEY_BASE_URL = "https://router.flatkey.ai/v1";
async function createImageThroughConfirmedRoute({ path, apiKey, body }) {
const response = await fetch(`${FLATKEY_BASE_URL}${path}`, {
method: "POST",
headers: {
Authorization: `Bearer ${apiKey}`,
"Content-Type": "application/json"
},
body: JSON.stringify(body)
});
if (!response.ok) {
throw new Error(`Pemeriksaan rute Flatkey gagal: ${response.status}`);
}
return response.json();
}
// Contoh hanya setelah konfirmasi dashboard:
await createImageThroughConfirmedRoute({
path: "/images/generations",
apiKey: process.env.FLATKEY_API_KEY,
body: {
model: "gpt-image-2",
prompt: "Buat gambar konsep produk yang bersih untuk dashboard penggunaan.",
size: "1536x1024",
quality: "medium",
output_format: "png"
}
});
Jika baris Flatkey saat ini masih hanya menampilkan openai, tanyakan ke product atau support bentuk permintaan mana yang didukung untuk baris GPT Image 2 API tersebut sebelum dirilis. Baris katalog dan path endpoint sama-sama diperlukan; salah satu tanpa yang lain bukan integrasi produksi.
Pemeriksaan Harga yang Perlu Dilakukan di Flatkey
Untuk artikel ini, panduan harga yang paling aman bersifat prosedural: verifikasi baris terkini di harga Flatkey, bandingkan dengan halaman harga gambar OpenAI saat ini, lalu konfirmasi penggunaan aktual yang dirutekan di log. Snapshot Flatkey 17 Juni membuktikan katalog memiliki baris GPT image, tetapi field baris menggunakan representasi harga yang berbeda. Itu cukup untuk membangun alur kerja peninjauan harga, tetapi tidak cukup untuk menerbitkan klaim harga permanen.
| Pertanyaan Harga | Apa yang Harus Dicatat | Mengapa Ini Penting |
|---|---|---|
| Baris mana yang dipilih? | Nama model yang tepat, grup, jenis kuota, dan jenis endpoint. | Beberapa baris keluarga gambar GPT dapat muncul dalam katalog yang sama. |
| Satuan apa yang ditampilkan? | Rasio token, harga per permintaan, unit per output, atau label khusus dashboard. | Mencampur satuan menyebabkan kesalahan anggaran meski nama modelnya benar. |
| Pengaturan apa yang mengubah biaya? | Kualitas, ukuran, panjang prompt, input gambar, format output, retry, dan perilaku batch. | Fitur API GPT Image 2 yang sama dapat memiliki tier biaya preview dan final-render. |
| Apa yang dicatat Flatkey? | Jumlah permintaan, status, penggunaan, biaya, baris model, dan alasan kegagalan. | Log membuktikan apakah penggunaan yang dirutekan cocok dengan estimasi. |
Tim yang membandingkan anggaran gambar juga sebaiknya membaca Harga OpenAI Image API dan Perbandingan Harga Model AI. Artikel-artikel tersebut membahas mekanisme biaya token, gambar, dan video yang lebih luas; halaman ini berfokus pada pemeriksaan rute GPT Image 2 API yang spesifik untuk Flatkey.
Rencana Smoke Test Sebelum Lalu Lintas Produksi
Jalankan serangkaian validasi kecil setelah baris dashboard, endpoint, dan satuan harga dikonfirmasi:
- Kirim satu permintaan baseline langsung ke OpenAI jika tim Anda memiliki akses OpenAI langsung.
- Kirim satu permintaan Flatkey melalui endpoint dan baris model yang telah dikonfirmasi.
- Bandingkan bentuk respons, format output, byte output, pesan kegagalan, dan latensi.
- Periksa log penggunaan Flatkey untuk baris model, jumlah permintaan, penggunaan, dan biaya.
- Ulangi dengan pengaturan produksi yang persis sama: kualitas, ukuran, latar belakang, format output, dan gambar input apa pun.
- Tetapkan batas retry dan kondisi penghentian sebelum mengekspos fitur ke pengguna.
- Sediakan jalur rollback ke workflow gambar sebelumnya atau rute provider langsung.
Ini adalah disiplin operasional yang sama seperti yang dijelaskan dalam panduan migrasi API yang kompatibel dengan OpenAI: ubah rute secara sengaja, petakan ID model, jalankan smoke test kecil, dan gunakan log sebelum melakukan scale-up.
Kapan Flatkey Menjadi Jalur API GPT Image 2 yang Tepat
Flatkey cocok ketika fitur gambar Anda menjadi bagian dari stack multimodal yang lebih luas. Sebuah produk dapat menggunakan model teks untuk menulis ulang prompt, model gambar GPT untuk pembuatan aset, model berkemampuan vision untuk review, dan penyedia lain untuk fallback atau kontrol biaya. Satu kunci, satu permukaan harga, dan satu dashboard penggunaan membuat alur kerja itu lebih mudah diaudit daripada akun penyedia yang terpisah.
Flatkey bukan alasan untuk melewati pemeriksaan di tingkat provider. Untuk GPT Image 2 API, status baris, dukungan endpoint, dan body permintaan harus selaras sebelum lalu lintas produksi. Snapshot 17 Juni menunjukkan keberadaan di katalog, bukan hasil ketersediaan yang bersih.
Daftar Periksa Final GPT Image 2 API
- Baris model utama dipilih di harga Flatkey.
- Dukungan endpoint dikonfirmasi untuk baris yang dipilih.
- Satuan harga dan label dashboard saat ini ditinjau.
- Test rute Flatkey kecil selesai dengan bentuk permintaan produksi.
- Log penggunaan diperiksa untuk baris, status, token atau unit permintaan, dan biaya.
- Batas retry, batas kuota, dan guardrail rollout dikonfigurasi.
- Rute rollback didokumentasikan.
Cara paling aman untuk mengadopsi GPT Image 2 API melalui Flatkey adalah memperlakukan akses model, dukungan endpoint, dan harga sebagai satu siklus validasi. Lihat Harga untuk memeriksa baris GPT image Flatkey saat ini sebelum memindahkan lalu lintas gambar yang sebenarnya.



