TokenLab
Dapatkan kunci API
DokumentasiReferensi APIIntegrasi

Gambar

Buat Variasi Gambar

Membuat variasi dari gambar yang diberikan

POST
/v1/images/variations

Ikhtisar

Endpoint ini dipertahankan untuk client variasi legacy yang kompatibel dengan OpenAI. Ini bukan jalur yang direkomendasikan untuk workflow image-to-image saat ini; gunakan /v1/images/edits dengan gpt-image-2 atau /v1/images/generations dengan model image-to-image seperti nano-banana-pro jika memungkinkan. Memerlukan multipart/form-data.

Isi Permintaan

Timeout permintaan sinkron: beberapa penyedia gambar yang dirutekan mengembalikan gambar final secara inline dan menunggu proses generasi selesai. Permintaan resolusi tinggi atau kualitas tinggi dapat memakan waktu hampir satu menit atau lebih, jadi atur timeout HTTP client Anda minimal 120s. Jika respons pembuatan berisi status: "pending", task_id, atau poll_url, ikuti poll_url yang dikembalikan.

imagefilewajib

Gambar sumber multipart. File dan seluruh body permintaan masing-masing tidak boleh melebihi 50 MiB. Format dan dimensi bergantung pada model; detail model saat ini harus mencantumkan /v1/images/variations secara eksplisit.

modelstringwajib

ID model wajib untuk rute legacy yang kompatibel dengan variasi. Tidak ada default implisit; untuk workflow image-to-image saat ini, pilih /v1/images/edits atau /v1/images/generations dengan model saat ini.

nintegerbawaan: 1

Jumlah gambar yang dibuat (1-10, tergantung model).

sizestring

Ukuran gambar yang dihasilkan untuk rute legacy yang kompatibel dengan variasi. Nilai yang didukung bergantung pada model yang dipilih.

response_formatstring

Format pengembalian gambar yang dihasilkan. Harus 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 yang dikodekan 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

Respons
{
  "created": 1706000000,
  "data": [
    {
      "url": "https://..."
    },
    {
      "url": "https://..."
    }
  ]
}

Catatan

Ini adalah endpoint kompatibilitas legacy. Endpoint ini tidak termasuk dalam katalog model gambar rekomendasi 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

Edit Gambar

Sebelumnya

Dapatkan Status Gambar

Berikutnya