Google: Gemini Embedding 2 (batch)
A Gemini Embedding 2 Batch szövegbeágyazási kérések csoportjait küldi be egyetlen Ailoot-kötegként. Minden tételt custom_id alapján kövess, és kérd le az eredeti művelet teljes eredményét.
A modellről
Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.
A Gemini Embedding 2 Batch a /v1/batches végpontot használja a pontos google/gemini-embedding-2:batch modellazonosítóval. Állítsd az endpoint mezőt /v1/embeddings értékre, és add meg a requests mezőt; minden tétel custom_id mezőt és egy body objektumot tartalmaz, amelyben az input szöveglánc vagy szövegláncok tömbje. Tartsd állandónak az azonosítókat, hogy az alkalmazás össze tudja rendelni az eredményeket az előkészített dokumentumgyűjteménnyel.
A köteg feldolgozása aszinkron. Őrizd meg az eredetileg visszaadott műveletazonosítót, és a GET /v1/batches/{operation_id} kéréssel kövesd ugyanazt a műveletet ugyanazzal a hívóval. Egy elkészült eredményhalmaz minden custom_id értékhez választ vagy hibát tartalmazhat, ezért az összesített állapot mellett az egyes tételek kimenetelét is vizsgáld meg.
Mentsd az összes elkészült eredményt JSONL formátumban, megőrizve minden custom_id értéket és annak teljes válaszát vagy hibáját. Az index frissítése előtt rendeld a sikeres vektorokat a beküldött dokumentumazonosítókhoz. Tartsd együtt az eredeti művelet és a tételek rekordjait, hogy a befejezetlen vagy hibás tétel a már visszaadott eredmények elvesztése nélkül vizsgálható legyen.
Ailoot Ultra · Batch POST /v1/batches google/gemini-embedding-2:batch
google/gemini-embedding-2:batch
google/gemini-embedding-2:batchKezdő lépések
A Gemini Embedding 2 Batch szövegbeágyazási kérések csoportjait küldi be egyetlen Ailoot-kötegként. Minden tételt custom_id alapján kövess, és kérd le az eredeti művelet teljes eredményét.
- Elfogadott bemenetek
- Szöveg
- Eredmények
- embedding
Elérhető az Ailootban · bemenetek és metódusok
Ailoot Ultra · Batch POST /v1/batches
- Bemenet
text- Kimenet
embedding
| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok google/gemini-embedding-2:batch Feltételek: Pontosan ezt az Ailoot-útválasztási azonosítót használja. | Alapértelmezett— |
Mezőendpoint | Típusstring | KövetelményKötelező | Értékek és korlátok /v1/embeddings Feltételek: | Alapértelmezett— |
Mezőrequests | Típusarray | KövetelményKötelező | Értékek és korlátok Feltételek: | Alapértelmezett— |
Metódus paraméterei és életciklusa
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, endpoint, requests |
Paraméteroptional | Szerződés |
Paramétermaterial_types | Szerződéstext |
Paraméterconditions | SzerződésPontosan ezt az Ailoot-útválasztási azonosítót használja. |
Életciklus: asynchronous
GET /v1/batches/{operation_id} · A tényleges eredeti response.id, ugyanazzal a hívóval, kulccsal és csoporttal.
Díjcsomagok
A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.
- Gyors mód
- Nincs megadva Ha a gyors mód van kiválasztva
- Flex mód
- Nincs megadva Ha a flex mód van kiválasztva
- Maximális gondolkodási ráfordítás
- Nincs megadva Ha a maximális gondolkodási ráfordításra a default beállításhoz tartozó korrekció vonatkozik
- Explicit gyorsítótárazás díjai
- Nincs engedélyezve Ha explicit gyorsítótárazást kérnek
Ailoot-díjak
Árak beállításonként
Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.
| Beállítás | Díjtáblázat | Kontextustokenek, több mint | Kontextustokenek, legfeljebb | Díj |
|---|---|---|---|---|
| BeállításTokenek alapdíjai | DíjtáblázatAlapdíj | Kontextustokenek, több mint— | Kontextustokenek, legfeljebbNincs felső korlát | Díj Bemenet · Bemeneti tokenek $0.0002 / 1K token Kimenet · Kimeneti tokenek $0 / 1K token Bemenet · Gyorsítótár olvasása — / 1K token Bemenet · Írás a gyorsítótárba — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra — / 1K token |
| BeállításA kéréshossz szerinti 1. ársáv | Díjtáblázat— | Kontextustokenek, több mint0 | Kontextustokenek, legfeljebbNincs felső korlát | Díj Bemenet · Bemeneti tokenek $0.0002 / 1K token Kimenet · Kimeneti tokenek $0 / 1K token Bemenet · Gyorsítótár olvasása — / 1K token Bemenet · Írás a gyorsítótárba — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra — / 1K token |
Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →
Példakérések
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
Eredmények fogadása és mentése
Ailoot Ultra · Batch
GET /v1/batches/{operation_id}
Őrizzen meg minden elkészült eredményt
Őrizzen meg minden teljes visszaadott választ, fájlt és tartalomrészt.
Őrizze meg az eredeti állapotot, minden custom_id értéket és a teljes választ vagy hibát. Mentsen minden elkészült results[] eredményt JSONL formátumban; ebből nem következik Files feltöltési vagy letöltési útvonal.
Ha az eredeti választ ellenőrizni kell
Őrizze meg az eredeti műveletazonosítót, és csak azt az eredeti köteget olvassa le. Az időtúllépés, hiba vagy ismeretlen állapot nem jogosít újabb létrehozásra.
Válaszmezők
| Mező | Típus |
|---|---|
Mezőresults[] | Típusarray |
Mezőresults[].custom_id | Típusstring |
Mezőresults[].response | Típusobject |
Mezőresults[].error | Típusobject |
Hibák és következő lépések
| Válasz | Feltétel | Következő lépés |
|---|---|---|
Válasz400 · invalid_request_error | FeltételEgy kötelező mező, modellválasztó, típus vagy bemeneti ábrázolási forma érvénytelen. | Következő lépésKülön kérés előkészítése előtt vizsgálja meg a visszaadott érvényesítési részleteket. |
Válasz | FeltételAz eredeti kérés vagy eredmény ismeretlen, vagy ellenőrzést igényel. | Következő lépésŐrizze meg az eredeti azonosítókat és fejléceket; csak a támogatott állapot- és médiatárbejegyzéseket olvassa le. Ne küldje el újra a létrehozási kérelmet. |
Álnevek
Modell álnevei
Ailoot Ultra google/gemini-embedding-2:batch
Metódusútvonalak álnevei
Használja a fent látható metódusútvonalakat.
Kapcsolódó modellazonosítók
FAQ · Google: Gemini Embedding 2 (batch)
- Milyen bemenetek és eredmények érhetők el?
POST /v1/batches·google/gemini-embedding-2:batch:text→embedding- Mely mezőket használja a kérés?
POST /v1/batches·google/gemini-embedding-2:batch:model,endpoint,requests