Gambar
Buat Variasi Gambar
Membuat variasi dari gambar yang diberikan
Gambaran Umum
Endpoint ini mendukung klien OpenAI Variations yang sudah ada. Untuk fitur image-to-image baru, gunakan /v1/images/edits atau /v1/images/generations dengan model image-to-image saat ini. Permintaan menggunakan multipart/form-data.
Body Permintaan
Endpoint ini bersifat sinkron: respons membawa gambar akhir dan tidak pernah berupa task. Atur timeout klien HTTP Anda setidaknya ke 120s.
Gambar sumber multipart. File dan request body lengkap masing-masing harus berukuran maksimal 50 MiB (unggahan yang lebih besar mengembalikan 413). Format dan dimensi yang didukung bergantung pada model yang dipilih. Hanya model yang detailnya memetakan image-to-image ke /v1/images/variations yang diterima; model lainnya akan mengembalikan 400.
ID Model. Endpoint ini tidak memiliki model default. Contoh-contoh menggunakan placeholder your-legacy-variation-model: ganti dengan model yang detailnya mencantumkan endpoint ini.
1Jumlah gambar yang akan dibuat (1-10, bergantung pada model).
Ukuran gambar yang dihasilkan. Nilai yang didukung bergantung pada model yang dipilih.
Format pengembalian gambar yang dihasilkan. Harus berupa url atau b64_json.
Pengidentifikasi unik yang mewakili pengguna akhir Anda untuk pemantauan penyalahgunaan.
Respons
Timestamp Unix saat gambar dibuat.
Array variasi gambar yang dihasilkan.
Setiap objek berisi:
url(string): URL gambar variasi (jika response_format adalahurl)b64_json(string): Gambar berkode Base64 (jika response_format adalahb64_json)
Permintaan
curl -X POST "https://api.tokenlab.sh/v1/images/variations" \
-H "Authorization: Bearer sk-your-api-key" \
-F "model=your-legacy-variation-model" \
-F "image=@cat.png" \
-F "n=2" \
-F "size=1024x1024"Respons
{
"created": 1706000000,
"data": [
{
"url": "https://..."
},
{
"url": "https://..."
}
]
}Catatan
Ini adalah endpoint kompatibilitas lawas (legacy). Endpoint ini tidak disertakan dalam katalog model gambar yang direkomendasikan saat ini. Untuk integrasi baru, gunakan /v1/images/edits dengan gpt-image-2, atau /v1/images/generations dengan operation: "image-to-image" dan model image-to-image saat ini.
Otorisasi
BearerAuth Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.
Lokasi: header
Header
Kebijakan Pengiriman per-permintaan. Menggantikan default API key dan Workspace. Secara otomatis mencoba TokenLab Verified terlebih dahulu dan dapat beralih satu kali ke Official saja sebelum output, penerimaan permintaan, atau pembuatan sumber daya persisten.
Nilai yang tersedia
- "auto"
- "verified"
- "official"
Body permintaan
multipart/form-data
Respons
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json