Generasi Gambar

TokenLab mendukung teks-ke-gambar, gambar-ke-gambar, dan pengeditan gambar melalui endpoint gambar publik. Model gambar tidak berbagi satu set parameter universal, jadi klien produksi harus terlebih dahulu memilih endpoint, kemudian memilih model, lalu mengirim hanya bidang yang didukung oleh model tersebut.

Kapan Menggunakan Setiap EndpointCopy Anchor Link

Selalu kirim model. Endpoint gambar secara sengaja tidak bergantung pada model default implisit historis untuk lalu lintas produksi.

Pilih ModelCopy Anchor Link

Mulailah dengan penemuan model, kemudian periksa kontrak TokenLab model yang dipilih:

curl "https://api.tokenlab.sh/v1/models?recommended_for=image" \
  -H "Authorization: Bearer sk-your-api-key"

Untuk model non-obrolan, respon daftar mungkin mencakup GET /v1/models. Halaman detail model mungkin mengekspos GET /v1/models/{model} yang lebih lengkap. Gunakan bidang tersebut untuk mengonfirmasi:

• Operasi yang didukung, seperti text-to-image, image-to-image, atau image-edit.
• Endpoint permintaan yang diharapkan oleh model.
• Bentuk mana yang harus digunakan untuk referensi, seperti image_url, image_urls, reference_image_urls, multipart image, atau JSON images[].
• Apakah model menerima size, aspect_ratio, resolution, quality, background, output_format, atau response_format.

Aturan Bentuk PermintaanCopy Anchor Link

• Permintaan gaya gpt-image-2 menggunakan bidang size, quality, dan edit yang mirip dengan OpenAI. Untuk pembuatan dan edit, background menerima auto atau opaque; transparent tidak didukung. Tinggalkan bidang opsional saat Anda ingin model atau TokenLab menggunakan default otomatis.
• Keluarga gambar Gemini dan Nano Banana biasanya menggunakan aspect_ratio; hanya kirim resolution saat kontrak model mengeksposnya.
• Gambar-ke-gambar Nano Banana berada di /v1/images/generations dengan operation: "image-to-image" dan URL gambar referensi.
• /v1/images/generations tidak menerima images[] atau file_id di tingkat atas; itu adalah bentuk alur edit.
• Referensi gambar jarak jauh harus berupa URL publik http atau https. Jangan kirim URL jaringan pribadi, kredensial yang tertanam, fragmen URL, atau URL yang ditandatangani yang mungkin kedaluwarsa sebelum pemrosesan dimulai.

Contoh Teks-Ke-GambarCopy Anchor Link

curl https://api.tokenlab.sh/v1/images/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Foto produk bersih dari cangkir kopi keramik di atas meja kenari",
    "size": "1024x1024",
    "response_format": "url"
  }'

Contoh Gambar-ReferensiCopy Anchor Link

curl https://api.tokenlab.sh/v1/images/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "operation": "image-to-image",
    "prompt": "Pertahankan bentuk produk, ubah latar belakang menjadi pengaturan studio yang cerah",
    "image_urls": ["https://example.com/input/product.png"],
    "aspect_ratio": "1:1"
  }'

Menangani HasilCopy Anchor Link

Respon gambar bisa bersifat sinkron atau asinkron:

• Respon sinkron mengembalikan data[] akhir dengan url atau b64_json.
• Respon asinkron mengembalikan id, task_id, status, dan biasanya poll_url.
• Utamakan poll_url saat tersedia. Jika Anda memerlukan rute tetap, lakukan polling GET /v1/tasks/{id}.
• Gunakan permintaan sinkron saat Anda secara khusus memerlukan b64_json; hasil gambar asinkron lebih berorientasi URL.

curl "https://api.tokenlab.sh/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer sk-your-api-key"

Simpan URL gambar yang dikembalikan, ID tugas, model, dan ID pengguna/pekerjaan Anda sendiri. Jangan terus melakukan polling setelah status terminal.

Daftar Periksa ProduksiCopy Anchor Link

• Validasi input pengguna sebelum memanggil TokenLab: panjang prompt, jumlah gambar, keterjangkauan URL, dan jenis file.
• Atur timeout HTTP cukup tinggi untuk permintaan sinkron resolusi tinggi. Gunakan mode asinkron di mana tersedia untuk pekerjaan yang lama.
• Simpan request_id, task_id, poll_url, model, endpoint, dan bentuk permintaan yang disanitasi untuk dukungan.
• Pada timeout klien, periksa apakah tugas telah dibuat sebelum mencoba ulang permintaan pembuatan.
• Rekonsiliasi biaya dengan catatan penggunaan dan billing_transaction_id saat ada, bukan dengan ID tugas penyedia.

Kesalahan UmumCopy Anchor Link

Referensi APICopy Anchor Link