Google: Gemini Embedding 2 (batch)
Gemini Embedding 2 Batch wysyła grupy żądań osadzeń tekstu jako jedną partię Ailoot. Śledź każdy element po custom_id i pobierz kompletne wyniki pierwotnej operacji.
O modelu
Ten opis przedstawia możliwości modelu. Dane wejściowe, wyniki i opcje dostępne w Ailoot podano poniżej dla wybranej metody.
Gemini Embedding 2 Batch korzysta z /v1/batches z dokładnym identyfikatorem modelu google/gemini-embedding-2:batch. Ustaw endpoint na /v1/embeddings i podaj requests; każdy element zawiera custom_id oraz body z input jako ciągiem tekstowym lub tablicą ciągów. Zachowuj stałe identyfikatory, aby aplikacja mogła przypisać wyniki do przygotowanego zbioru dokumentów.
Partia jest asynchroniczna. Zachowaj pierwotny zwrócony identyfikator operacji i używaj GET /v1/batches/{operation_id}, aby śledzić tę samą operację z tą samą tożsamością wywołującą. Gotowy zbiór wyników może zawierać odpowiedź lub błąd dla każdego custom_id, dlatego sprawdzaj wyniki poszczególnych elementów oraz stan całej partii.
Zapisz wszystkie gotowe wyniki jako JSONL, zachowując każdy custom_id i pełną odpowiedź lub błąd. Powiąż poprawnie zwrócone wektory z wysłanymi identyfikatorami dokumentów przed aktualizacją indeksu. Trzymaj razem zapisy pierwotnej operacji i elementów, aby można było zbadać niekompletny lub błędny element bez utraty już zwróconych wyników.
Ailoot Ultra · Batch POST /v1/batches google/gemini-embedding-2:batch
google/gemini-embedding-2:batch
google/gemini-embedding-2:batchStart
Gemini Embedding 2 Batch wysyła grupy żądań osadzeń tekstu jako jedną partię Ailoot. Śledź każdy element po custom_id i pobierz kompletne wyniki pierwotnej operacji.
- Akceptowane dane wejściowe
- Tekst
- Wyniki
- embedding
Dostępne w Ailoot · dane wejściowe i metody
Ailoot Ultra · Batch POST /v1/batches
- Wejście
text- Wyjście
embedding
| Pole | Typ | Wymaganie | Wartości i limity | Domyślnie |
|---|---|---|---|---|
Polemodel | Typstring | WymaganieWymagane | Wartości i limity google/gemini-embedding-2:batch Warunki: Użyj dokładnie tego selektora trasowania Ailoot. | Domyślnie— |
Poleendpoint | Typstring | WymaganieWymagane | Wartości i limity /v1/embeddings Warunki: | Domyślnie— |
Polerequests | Typarray | WymaganieWymagane | Wartości i limity Warunki: | Domyślnie— |
Parametry i cykl życia metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, endpoint, requests |
Parametroptional | Kontrakt |
Parametrmaterial_types | Kontrakttext |
Parametrconditions | KontraktUżyj dokładnie tego selektora trasowania Ailoot. |
Cykl życia: asynchronous
GET /v1/batches/{operation_id} · Rzeczywiste oryginalne response.id, ten sam wywołujący, klucz i grupa.
Cennik
Informacje taryfowe nie dodają opcji żądania. Obsługiwane parametry podano przy wybranej metodzie.
- Tryb szybki
- Nie określono Gdy wybrany jest tryb szybki
- Tryb flex
- Nie określono Gdy wybrany jest tryb flex
- Maksymalna intensywność rozumowania
- Nie określono Gdy dla maksymalnej intensywności rozumowania stosowana jest domyślna korekta (default)
- Wycena jawnej pamięci podręcznej
- Niewłączone Gdy zażądano jawnej pamięci podręcznej
Stawki Ailoot
Ceny według konfiguracji
Dopasuj każdą opłatę do pokazanych warunków. Użyj jednej stawki dla każdego zestawu alternatywnych konfiguracji.
| Konfiguracja | Tabela stawek | Tokeny kontekstu, więcej niż | Tokeny kontekstu, do podanej wartości włącznie | Opłata |
|---|---|---|---|---|
| KonfiguracjaBazowe stawki za tokeny | Tabela stawekStawka podstawowa | Tokeny kontekstu, więcej niż— | Tokeny kontekstu, do podanej wartości włącznieBez górnej granicy | Opłata Wejście · Tokeny wejściowe $0.0002 / 1K tokenów Wyjście · Tokeny wyjściowe $0 / 1K tokenów Wejście · Odczyt cache — / 1K tokenów Wejście · Zapis do cache — / 1K tokenów Wejście · Zapis do cache, 1 godz. — / 1K tokenów |
| KonfiguracjaPrzedział długości żądania 1 | Tabela stawek— | Tokeny kontekstu, więcej niż0 | Tokeny kontekstu, do podanej wartości włącznieBez górnej granicy | Opłata Wejście · Tokeny wejściowe $0.0002 / 1K tokenów Wyjście · Tokeny wyjściowe $0 / 1K tokenów Wejście · Odczyt cache — / 1K tokenów Wejście · Zapis do cache — / 1K tokenów Wejście · Zapis do cache, 1 godz. — / 1K tokenów |
Ailoot rezerwuje szacowaną kwotę przed żądaniem. Po otrzymaniu wyniku rozlicza ostateczną opłatę według zmierzonego użycia. Rozliczenie strumieniowania korzysta z końcowego rekordu użycia. Jak działają rezerwacja i rozliczenie →
Przykładowe żądania
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
Odbieranie i zapisywanie wyników
Ailoot Ultra · Batch
GET /v1/batches/{operation_id}
Zachowaj wszystkie ukończone wyniki
Zachowaj każdą kompletną zwróconą odpowiedź, plik i część treści.
Zachowaj oryginalny status, każdy custom_id i pełną odpowiedź lub błąd. Zapisz wszystkie ukończone results[] w formacie JSONL; nie zakłada się żadnej ścieżki przesyłania ani pobierania przez Files.
Jeśli trzeba sprawdzić pierwotną odpowiedź
Zachowaj oryginalne ID operacji i odczytuj tylko tę oryginalną partię. Przekroczenie limitu czasu, błąd ani nieznany stan nie upoważniają do kolejnego utworzenia.
Pola odpowiedzi
| Pole | Typ |
|---|---|
Poleresults[] | Typarray |
Poleresults[].custom_id | Typstring |
Poleresults[].response | Typobject |
Poleresults[].error | Typobject |
Błędy i dalsze kroki
| Odpowiedź | Warunek | Następny krok |
|---|---|---|
Odpowiedź400 · invalid_request_error | WarunekWymagane pole, selektor modelu, typ lub postać danych wejściowych są nieprawidłowe. | Następny krokPrzed przygotowaniem osobnego żądania sprawdź zwrócone szczegóły walidacji. |
Odpowiedź | WarunekOryginalne żądanie lub wynik są nieznane albo wymagają sprawdzenia. | Następny krokZachowaj oryginalne identyfikatory i nagłówki; odczytuj tylko obsługiwane rekordy statusu lub biblioteki. Nie wysyłaj ponownie żądania utworzenia. |
Aliasy
Aliasy modelu
Ailoot Ultra google/gemini-embedding-2:batch
Aliasy ścieżek metod
Użyj ścieżek metod podanych powyżej.
Powiązane ID modeli
FAQ · Google: Gemini Embedding 2 (batch)
- Jakie dane wejściowe i wyniki są dostępne?
POST /v1/batches·google/gemini-embedding-2:batch:text→embedding- Jakich pól używa żądanie?
POST /v1/batches·google/gemini-embedding-2:batch:model,endpoint,requests