Google: Gemini Embedding 2 (batch)
Gemini Embedding 2 Batch mengirim kelompok permintaan embedding teks sebagai satu batch Ailoot. Lacak setiap item melalui custom_id dan ambil hasil lengkap dari operasi asli.
Tentang model
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
Gemini Embedding 2 Batch menggunakan /v1/batches dengan ID model google/gemini-embedding-2:batch yang persis. Atur endpoint ke /v1/embeddings dan berikan requests; setiap item berisi custom_id dan body dengan input berupa string teks atau array string. Pertahankan pengenal agar tetap stabil sehingga aplikasi dapat mencocokkan hasil dengan koleksi dokumen yang telah disiapkan.
Batch berjalan secara asinkron. Simpan ID operasi asli yang dikembalikan dan gunakan GET /v1/batches/{operation_id} untuk mengikuti operasi yang sama dengan pemanggil yang sama. Kumpulan hasil yang selesai dapat memuat response atau error untuk setiap custom_id, sehingga periksa hasil per item maupun status keseluruhan.
Simpan seluruh hasil yang selesai sebagai JSONL sambil mempertahankan setiap custom_id dan response atau error lengkapnya. Hubungkan vektor yang berhasil dengan ID dokumen yang dikirim sebelum memperbarui indeks. Simpan catatan operasi asli bersama catatan item agar item yang belum lengkap atau gagal dapat diselidiki tanpa kehilangan hasil yang sudah dikembalikan.
Ailoot Ultra · Batch POST /v1/batches google/gemini-embedding-2:batch
google/gemini-embedding-2:batch
google/gemini-embedding-2:batchMulai
Gemini Embedding 2 Batch mengirim kelompok permintaan embedding teks sebagai satu batch Ailoot. Lacak setiap item melalui custom_id dan ambil hasil lengkap dari operasi asli.
- Masukan yang diterima
- Teks
- Hasil
- embedding
Tersedia di Ailoot · masukan & metode
Ailoot Ultra · Batch POST /v1/batches
- Masukan
text- Keluaran
embedding
| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan google/gemini-embedding-2:batch Kondisi: Gunakan pemilih perutean Ailoot ini persis seperti yang ditampilkan. | Bawaan— |
Kolomendpoint | Jenisstring | PersyaratanWajib | Nilai & batasan /v1/embeddings Kondisi: | Bawaan— |
Kolomrequests | Jenisarray | PersyaratanWajib | Nilai & batasan Kondisi: | Bawaan— |
Parameter metode dan siklus hidup
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, endpoint, requests |
Parameteroptional | Kontrak |
Parametermaterial_types | Kontraktext |
Parameterconditions | KontrakGunakan pemilih perutean Ailoot ini persis seperti yang ditampilkan. |
Siklus hidup: asynchronous
GET /v1/batches/{operation_id} · response.id asli yang sebenarnya, dengan pemanggil/kunci/grup yang sama
Paket
Referensi tarif tidak menambah opsi permintaan. Parameter yang didukung tercantum pada metode yang dipilih.
- Mode Fast
- Tidak ditentukan Saat mode fast dipilih
- Mode Flex
- Tidak ditentukan Saat mode flex dipilih
- Upaya penalaran maksimum
- Tidak ditentukan Saat upaya penalaran maksimum menggunakan penyesuaian default
- Harga cache eksplisit
- Tidak diaktifkan Saat cache eksplisit diminta
Tarif Ailoot
Harga menurut konfigurasi
Cocokkan setiap biaya dengan kondisi yang ditampilkan. Gunakan satu tarif untuk setiap kelompok konfigurasi alternatif.
| Konfigurasi | Jadwal tarif | Token konteks, lebih dari | Token konteks, hingga dan termasuk | Biaya |
|---|---|---|---|---|
| KonfigurasiTarif dasar token | Jadwal tarifTarif dasar | Token konteks, lebih dari— | Token konteks, hingga dan termasukTanpa batas atas | Biaya Masukan · Token masukan $0.0002 / 1K token Keluaran · Token keluaran $0 / 1K token Masukan · Pembacaan cache — / 1K token Masukan · Penulisan cache — / 1K token Masukan · Penulisan cache, 1 jam — / 1K token |
| KonfigurasiPanjang permintaan · tingkat 1 | Jadwal tarif— | Token konteks, lebih dari0 | Token konteks, hingga dan termasukTanpa batas atas | Biaya Masukan · Token masukan $0.0002 / 1K token Keluaran · Token keluaran $0 / 1K token Masukan · Pembacaan cache — / 1K token Masukan · Penulisan cache — / 1K token Masukan · Penulisan cache, 1 jam — / 1K token |
Ailoot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →
Contoh permintaan
Ailoot Ultra · Batch
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"endpoint": "/v1/embeddings", "model": "google/gemini-embedding-2:batch", "requests": [{"custom_id": "embedding-1", "body": {"input": "The quick brown fox jumps over the lazy dog"}}]}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/batches \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_BATCH'
import json,os,subprocess
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path("result.json").read_text()); operation=r["id"]
subprocess.run(["curl","--fail-with-body","--silent","--show-error","https://api.ailoot.ai/v1/batches/"+quote(operation,safe=""),"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
s=json.loads(Path("status.json").read_text())
if s.get("status")=="completed": Path("results.jsonl").write_text("".join(json.dumps(x,ensure_ascii=False)+"\n" for x in s.get("results",[])))
# Repeat only this same original GET while pending; never repeat creation.
PY_BATCH
Terima dan simpan hasil
Ailoot Ultra · Batch
GET /v1/batches/{operation_id}
Simpan semua hasil yang selesai
Simpan setiap respons lengkap, berkas, dan bagian konten yang dikembalikan.
Simpan status asli, setiap custom_id, dan respons/kesalahan lengkap. Simpan semua results[] yang selesai sebagai JSONL; jangan mengasumsikan adanya alur unggah/unduh Files.
Jika respons asli perlu diperiksa
Simpan ID operasi asli dan baca hanya batch asli tersebut. Waktu tunggu habis, kesalahan, atau status yang tidak diketahui tidak mengizinkan permintaan pembuatan baru.
Kolom respons
| Kolom | Jenis |
|---|---|
Kolomresults[] | Jenisarray |
Kolomresults[].custom_id | Jenisstring |
Kolomresults[].response | Jenisobject |
Kolomresults[].error | Jenisobject |
Kesalahan dan langkah berikutnya
| Respons | Kondisi | Langkah berikutnya |
|---|---|---|
Respons400 · invalid_request_error | KondisiKolom wajib, pemilih model, tipe, atau bentuk masukan tidak valid. | Langkah berikutnyaPeriksa rincian validasi yang dikembalikan sebelum menyiapkan permintaan terpisah. |
Respons | KondisiPermintaan atau hasil asli tidak diketahui atau perlu diperiksa. | Langkah berikutnyaSimpan pengenal dan header asli; baca hanya catatan status/pustaka yang didukung. Jangan kirim ulang permintaan pembuatan. |
Alias
Alias model
Ailoot Ultra google/gemini-embedding-2:batch
Alias jalur metode
Gunakan jalur metode yang ditampilkan di atas.
ID pemanggil terkait
FAQ · Google: Gemini Embedding 2 (batch)
- Input dan hasil apa yang tersedia?
POST /v1/batches·google/gemini-embedding-2:batch:text→embedding- Kolom apa yang digunakan permintaan?
POST /v1/batches·google/gemini-embedding-2:batch:model,endpoint,requests