Google: Gemini Embedding 2 (batch)
Gemini Embedding 2 Batch verstuurt groepen tekstembeddingverzoeken als één Ailoot-batch. Volg elk item via custom_id en haal de volledige resultaten van de oorspronkelijke bewerking op.
Over het model
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Gemini Embedding 2 Batch gebruikt /v1/batches met de exacte model-ID google/gemini-embedding-2:batch. Stel endpoint in op /v1/embeddings en geef requests mee; elk item bevat custom_id en een body met input als tekststring of array van strings. Houd de identificaties stabiel, zodat je toepassing de resultaten aan een voorbereide documentverzameling kan koppelen.
De batch is asynchroon. Bewaar de oorspronkelijk teruggegeven bewerkings-ID en gebruik GET /v1/batches/{operation_id} om diezelfde bewerking met dezelfde aanroeper te volgen. Een voltooide resultatenset kan voor elke custom_id een antwoord of fout bevatten. Bekijk daarom zowel de uitkomst per item als de algemene status.
Sla alle voltooide resultaten op als JSONL en bewaar daarbij elke custom_id met het volledige antwoord of de volledige fout. Koppel geslaagde vectoren aan de verstuurde document-ID’s voordat je de index bijwerkt. Houd de oorspronkelijke bewerking en de itemrecords samen, zodat een onvolledig of mislukt item kan worden onderzocht zonder de al teruggegeven resultaten te verliezen.
Ailoot Ultra · Batch POST /v1/batches google/gemini-embedding-2:batch
google/gemini-embedding-2:batch
google/gemini-embedding-2:batchAan de slag
Gemini Embedding 2 Batch verstuurt groepen tekstembeddingverzoeken als één Ailoot-batch. Volg elk item via custom_id en haal de volledige resultaten van de oorspronkelijke bewerking op.
- Toegestane invoer
- Tekst
- Resultaten
- embedding
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · Batch POST /v1/batches
- Invoer
text- Uitvoer
embedding
| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten google/gemini-embedding-2:batch Voorwaarden: Gebruik precies deze Ailoot-routeringsselector. | Standaard— |
Veldendpoint | Typestring | VereisteVereist | Waarden en limieten /v1/embeddings Voorwaarden: | Standaard— |
Veldrequests | Typearray | VereisteVereist | Waarden en limieten Voorwaarden: | Standaard— |
Methodeparameters en levenscyclus
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, endpoint, requests |
Parameteroptional | Contract |
Parametermaterial_types | Contracttext |
Parameterconditions | ContractGebruik precies deze Ailoot-routeringsselector. |
Levenscyclus: asynchronous
GET /v1/batches/{operation_id} · De werkelijke oorspronkelijke response.id, met dezelfde aanroeper, sleutel en groep.
Tarieven
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
- Snelle modus
- Niet opgegeven Wanneer de snelle modus geselecteerd is
- Flex-modus
- Niet opgegeven Wanneer de flex-modus geselecteerd is
- Maximale redeneerinspanning
- Niet opgegeven Wanneer voor maximale redeneerinspanning de default-aanpassing wordt gebruikt
- Tarieven voor expliciete caching
- Niet ingeschakeld Wanneer expliciete caching wordt aangevraagd
Ailoot-tarieven
Prijzen per configuratie
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Contexttokens, meer dan | Contexttokens, tot en met | Kosten |
|---|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Contexttokens, meer dan— | Contexttokens, tot en metGeen bovengrens | Kosten Invoer · Invoertokens $0.0002 / 1K tokens Uitvoer · Uitvoertokens $0 / 1K tokens Invoer · Cache lezen — / 1K tokens Invoer · Cache schrijven — / 1K tokens Invoer · Cache schrijven, 1 uur — / 1K tokens |
| ConfiguratieAanvraaglengte · niveau 1 | Tariefstaffel— | Contexttokens, meer dan0 | Contexttokens, tot en metGeen bovengrens | Kosten Invoer · Invoertokens $0.0002 / 1K tokens Uitvoer · Uitvoertokens $0 / 1K tokens Invoer · Cache lezen — / 1K tokens Invoer · Cache schrijven — / 1K tokens Invoer · Cache schrijven, 1 uur — / 1K tokens |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
Voorbeeldverzoeken
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
Resultaten ophalen en opslaan
Ailoot Ultra · Batch
GET /v1/batches/{operation_id}
Alle voltooide resultaten bewaren
Bewaar elk volledig teruggegeven antwoord, bestand en inhoudsonderdeel.
Bewaar de oorspronkelijke status, elke custom_id en het volledige antwoord of de volledige fout. Sla alle voltooide results[] op als JSONL; hieruit wordt geen upload- of downloadpad via Files afgeleid.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Bewaar de oorspronkelijke bewerkings-ID en raadpleeg enkel die oorspronkelijke batch. Een time-out, fout of onbekende status geeft geen toestemming om opnieuw een aanmaakverzoek in te dienen.
Antwoordvelden
| Veld | Type |
|---|---|
Veldresults[] | Typearray |
Veldresults[].custom_id | Typestring |
Veldresults[].response | Typeobject |
Veldresults[].error | Typeobject |
Fouten en vervolgstappen
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord400 · invalid_request_error | VoorwaardeEen verplicht veld, modelselector, type of invoerrepresentatie is ongeldig. | Volgende stapBekijk de teruggegeven validatiedetails voor u een afzonderlijk verzoek voorbereidt. |
Antwoord | VoorwaardeHet oorspronkelijke verzoek of resultaat is onbekend of moet nagekeken worden. | Volgende stapBewaar de oorspronkelijke identificatoren en headers; raadpleeg enkel ondersteunde statusgegevens of bibliotheekrecords. Dien het aanmaakverzoek niet opnieuw in. |
Aliasnamen
Modelaliasnamen
Ailoot Ultra google/gemini-embedding-2:batch
Aliasnamen voor methodepaden
Gebruik de hierboven getoonde methodepaden.
Gerelateerde aanroeper-ID’s
FAQ · Google: Gemini Embedding 2 (batch)
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/batches·google/gemini-embedding-2:batch:text→embedding- Welke velden gebruikt het verzoek?
POST /v1/batches·google/gemini-embedding-2:batch:model,endpoint,requests