GPT Image 2.5 Sunburst API
Endpoint dan autentikasi
TeamoRouter menggunakan format yang kompatibel dengan OpenAI Images API:
- Membuat gambar:
POST https://api.teamorouter.com/v1/images/generations - Mengedit gambar:
POST https://api.teamorouter.com/v1/images/edits
Header permintaan:
Authorization: Bearer sk-teamo-xxxxxx
Content-Type: application/json
Endpoint edit juga menerima multipart/form-data untuk mengunggah file gambar.
Membuat gambar
Permintaan minimal:
curl https://api.teamorouter.com/v1/images/generations \
-H "Authorization: Bearer sk-teamo-xxxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2.5-sunburst",
"prompt": "An orange tabby cat typing on a keyboard, illustration style"
}'
Tentukan ukuran dan kualitas:
{
"model": "gpt-image-2.5-sunburst",
"prompt": "An orange tabby cat typing on a keyboard, illustration style",
"size": "2048x2048",
"quality": "high"
}
Parameter umum:
| Parameter | Deskripsi |
|---|---|
model |
Gunakan gpt-image-2.5-sunburst. Harus ditentukan secara eksplisit; jika model dihilangkan, gpt-image-2 yang digunakan secara default. |
prompt |
Deskripsi gambar yang ingin dibuat. |
size |
auto atau lebarxtinggi, misalnya 1024x1024, 2048x2048, 3840x2160. |
quality |
low, medium, high, atau auto. |
n |
Jumlah gambar yang dibuat per permintaan. Default 1. |
output_format |
png, jpeg, atau webp. |
output_compression |
Tingkat kompresi JPEG/WebP, 0 sampai 100. |
background |
transparent, opaque, atau auto. Dengan transparent, gambar yang dikembalikan memiliki kanal alfa; padukan dengan output_format bernilai png atau webp. |
moderation |
Tingkat ketatnya moderasi konten, low atau auto. |
stream |
Setel ke true untuk melakukan streaming respons melalui SSE: chunk perantara memiliki object bernilai image.generation.chunk, chunk terakhir memiliki object bernilai image.generation.result dengan gambar hasil di data[0].b64_json, diikuti data: [DONE]. |
partial_images |
0 sampai 3. Saat ini chunk perantara tidak membawa gambar; hanya chunk terakhir yang membawa hasil. |
user |
Pengenal pengguna akhir yang ditentukan pemanggil, diteruskan apa adanya. |
Batasan ukuran OpenAI untuk gpt-image-2.5-sunburst: sisi terpanjang tidak boleh melebihi 3840 piksel; lebar dan tinggi harus kelipatan 16; rasio aspek tidak boleh melebihi 3:1; dan total piksel harus antara 655,360 dan 8,294,400. Ukuran dinyatakan dalam dimensi piksel, bukan string tetap 1k, 2k, 4k.
Mengedit gambar
curl https://api.teamorouter.com/v1/images/edits \
-H "Authorization: Bearer sk-teamo-xxxxxx" \
-F "model=gpt-image-2.5-sunburst" \
-F "prompt=Replace the background with snowy mountains" \
-F "image=@input.png" \
-F "size=1024x1024"
Parameter umum:
| Parameter | Deskripsi |
|---|---|
model |
Gunakan gpt-image-2.5-sunburst. |
image |
File gambar sumber. |
mask |
File gambar mask; area transparan dapat diedit. Ukurannya harus sama dengan gambar sumber. |
prompt |
Instruksi edit. |
n |
Jumlah gambar yang dibuat per permintaan. Default 1. |
size |
auto atau lebarxtinggi. |
quality |
low, medium, high, atau auto. |
background |
transparent, opaque, atau auto. Dalam pengujian, gambar yang dikembalikan endpoint edit tidak memiliki kanal alfa. |
input_fidelity |
Seberapa setia detail gambar sumber dipertahankan, high atau low. |
output_format |
png, jpeg, atau webp. |
output_compression |
Tingkat kompresi JPEG/WebP, 0 sampai 100. |
stream |
Setel ke true untuk melakukan streaming respons melalui SSE. Format event sama dengan pembuatan gambar. |
partial_images |
0 sampai 3. |
user |
Pengenal pengguna akhir yang ditentukan pemanggil, diteruskan apa adanya. |
Aturan ukuran dan tagihan
Pembuatan gambar ditagih per gambar. Harga satuan setiap gambar ditentukan oleh resolusi sebenarnya, dalam tiga tingkat berdasarkan sisi terpanjang:
| Sisi terpanjang gambar output | Tingkat |
|---|---|
| Hingga 1024 | 1K |
| Hingga 2048 | 2K |
| Di atas 2048 | 4K |
Tingkat ditentukan oleh lebar dan tinggi sebenarnya dari gambar yang dikembalikan, bukan oleh parameter permintaan. Jika size bernilai auto, dihilangkan, atau kosong, tagihan mengikuti ukuran yang benar-benar dihasilkan model; tanpa size, model secara default menghasilkan 1024 atau 1254 piksel, masing-masing ditagih sebagai 1K atau 2K. Tentukan size secara eksplisit jika Anda memerlukan tingkat yang tetap. Lihat harga terkini untuk harga ketiga tingkat tersebut.