Konfigurasi OpenAI Images API
Pembuatan gambar bukanlah antarmuka chat biasa. Meskipun penyedia AI mendukung model teks, itu tidak selalu berarti penyedia tersebut mendukung antarmuka gambar OpenAI. Periksa dengan penyedia apakah mereka secara eksplisit menyebutkan 'Images API', 'pembuatan gambar', atau model terkait sebelum melakukan konfigurasi.
Informasi resmi Unduhan dan dokumentasi mengacu pada situs resmi.
Pastikan terlebih dahulu apakah penyedia mendukung antarmuka gambar
| Hal yang perlu diperiksa | Cara melihat | Alasan |
|---|---|---|
| Tipe antarmuka | Apakah backend atau dokumentasi secara eksplisit menyebutkan Images API, pembuatan gambar, pengeditan gambar | Hanya menuliskan antarmuka chat yang kompatibel dengan OpenAI tidak berarti antarmuka gambar juga tersedia |
| Izin model | Apakah daftar model menyertakan model gambar, dan apakah akun atau Key memiliki izin | Model gambar sering kali ditagih secara terpisah dan diaktifkan secara terpisah dari model teks |
| Jalur permintaan | Apakah penyedia telah memberikan contoh untuk antarmuka gambar | Beberapa penyedia hanya mem-proxy antarmuka chat; meminta jalur gambar secara langsung akan menghasilkan 404 |
| Harga | Gambar ditagih per gambar, ukuran, atau kualitas | Uji coba dengan jumlah kecil sebelum pembuatan batch untuk menghindari penggunaan kuota yang tinggi sekaligus |
Perbedaan dengan antarmuka chat
| Tipe | Antarmuka umum | Persiapan yang diperlukan |
|---|---|---|
| Chat teks | /v1/chat/completions atau Responses | Key, Base URL, nama model, konten pesan |
| Pembuatan gambar | /v1/images/generations | Key, model gambar, prompt, ukuran, format output |
| Pengeditan gambar | Antarmuka pengeditan gambar | Selain prompt, Anda juga perlu mengunggah gambar asli atau mask |
Cara mengisi field
| Item konfigurasi | Metode pengisian |
|---|---|
| Endpoint | https://api.openai.com/v1/images/generations |
| Model | Contoh resmi yang tersedia: <code>gpt-image-2</code>; untuk layanan penyedia, isi sesuai dengan daftar penyedia |
| Prompt | Gambar apa yang ingin Anda buat |
| Size | Ukuran gambar |
| Format | URL atau base64 |
Jika menggunakan penyedia, ganti bagian domain resmi dengan alamat API gambar yang disediakan oleh penyedia; jika penyedia tidak menentukan dukungan untuk antarmuka gambar, jangan berasumsi bahwa itu tersedia. Apakah Base URL menyertakan /v1 tetap ikuti contoh backend, jangan menebak sendiri.
Contoh permintaan
Contoh pembuatan gambar OpenAI
curl https://api.openai.com/v1/images/generations \ -H "Authorization: Bearer YOUR_OPENAI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-image-2", "prompt": "A clean product photo of a white ceramic mug on a solid-color background", "size": "1024x1024" }'Biaya antarmuka gambar biasanya berbeda dari antarmuka teks. Periksa harga sebelum pembuatan batch.
| Error | Penyebab Umum | Solusi |
|---|---|---|
| 404 / endpoint not found | Penyedia tidak memiliki antarmuka proxy gambar, atau jalur kelebihan/kekurangan garis miring /v1 | Buka backend untuk menemukan contoh antarmuka gambar khusus; jangan langsung menggunakan antarmuka chat |
| model not found | Nama model gambar tidak ada di daftar penyedia saat ini | Salin ID model/nama model asli dari model gambar, bukan model teks |
| unsupported content type | Antarmuka pengeditan gambar memerlukan pengunggahan file; Anda tidak bisa hanya mengirim JSON | Pastikan terlebih dahulu apakah Anda memanggil antarmuka pembuatan atau antarmuka pengeditan |