Gambar

Buat Variasi Gambar

Membuat variasi dari gambar yang diberikan

POST
/v1/images/variations

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.

imagefilewajib

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.

modelstringwajib

ID Model. Endpoint ini tidak memiliki model default. Contoh-contoh menggunakan placeholder your-legacy-variation-model: ganti dengan model yang detailnya mencantumkan endpoint ini.

nintegerbawaan: 1

Jumlah gambar yang akan dibuat (1-10, bergantung pada model).

sizestring

Ukuran gambar yang dihasilkan. Nilai yang didukung bergantung pada model yang dipilih.

response_formatstring

Format pengembalian gambar yang dihasilkan. Harus berupa url atau b64_json.

userstring

Pengidentifikasi unik yang mewakili pengguna akhir Anda untuk pemantauan penyalahgunaan.

Respons

createdinteger

Timestamp Unix saat gambar dibuat.

dataarray

Array variasi gambar yang dihasilkan.

Setiap objek berisi:

  • url (string): URL gambar variasi (jika response_format adalah url)
  • b64_json (string): Gambar berkode Base64 (jika response_format adalah b64_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

Response
{
  "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
AuthorizationBearer <token>

Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.

Lokasi: header

Header

X-TokenLab-Delivery-Policy?string

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