Google: Gemini Embedding 2
Gemini Embedding 2 mapuje text, obrázky, zvuk, video a PDF do spoločného číselného priestoru. Jeho vektory podporujú vyhľadávanie medzi modalitami, získavanie materiálu, klasifikáciu a zhlukovanie s flexibilnými rozmermi a vstupným limitom 8192 tokenov.
O modeli
Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.
Gemini Embedding 2 je multimodálny model embeddingov od Google na číselnú reprezentáciu textu, obrázkov, videa, zvuku a PDF. Rôzne typy médií mapuje do spoločného priestoru, aby aplikácia mohla porovnávať ich význam. Výsledkom je vektor čísel užitočný na sémantické vyhľadávanie, získavanie dokumentov, odporúčanie, klasifikáciu či zhlukovanie; nejde o písomnú odpoveď ani generovaný mediálny súbor. Google dokumentuje sémantické pokrytie viac ako 100 jazykov.
Pri znalostnej báze vytvorte vektory zdrojových pasáží, porovnajte s nimi dopyt používateľa a vyhľadajte relevantný materiál. Samostatný textový model potom môže zostaviť odpoveď s využitím týchto zdrojov. Pri mediálnej kolekcii môže textový opis hľadať súvisiace obrázky či video; dopytom môže byť aj obrázok. Zachovajte spojenie každého vektora s pôvodným obsahom vrátane odkazu na stranu alebo klip, aby sa vyhľadaný výsledok dal preskúmať a ukázať v pôvodnom kontexte.
Celkový vstupný limit je 8192 tokenov. Príručka stabilného modelu povoľuje najviac šesť obrázkov PNG alebo JPEG, najviac 180 sekúnd zvuku MP3 alebo WAV a najviac 120 sekúnd videa MP4 alebo MOV. Zdokumentované videokodeky sú H264, H265, AV1 a VP9. Spracovanie videa používa najviac 32 snímok: klipy do 32 sekúnd sa vzorkujú jednou snímkou za sekundu, dlhšie klipy rovnomerne na 32 snímok. Zvuková stopa videa sa v tomto videovstupe nespracúva; keď je dôležitá pre vyhľadávanie, vytvorte jej embedding samostatne.
Vstup PDF prijíma jeden súbor najviac so šiestimi stranami. Google pre najlepšiu kvalitu odporúča jednu stranu na PDF. Väčší zdroj rozdeľte na zmysluplné strany alebo časti a uchovajte ich vzťah k pôvodnému dokumentu. Vyberte výňatok predstavujúci to, čo má byť vyhľadateľné, namiesto spájania nesúvisiaceho materiálu iba preto, že sa zmestí do limitu. Spoločná tokenová hranica stále platí pre požiadavku s kombinovanými médiami. Každá strana PDF spotrebuje 258 vizuálnych tokenov navyše k tokenom extrahovaného textu. V zdokumentovanom postupe Google sa obsah prekračujúci spoločný limit 8192 tokenov skráti bez chyby.
Výstupná rozmernosť je flexibilná od 128 do 3072 s predvolenými 3072 a odporúčanými veľkosťami 768, 1536 a 3072. Model používa Matryoshka Representation Learning, takže prefixy vektora zostávajú užitočné pri menších rozmeroch. Príručka dokumentuje automatickú normalizáciu predvolených aj skrátených vektorov. Pre záznamy a dopyty porovnávané aplikáciou vyberte jednotný rozmer; požadovaná veľkosť mení číselnú reprezentáciu, nie samotný zdrojový obsah.
Pri výlučne textových úlohách zahrňte účel do textu namiesto použitia staršieho poľa task_type. Google rozlišuje asymetrické vyhľadávanie od symetrického porovnávania. Vyhľadávací dopyt používa “task: search result | query: {content}”, zdrojový dokument “title: {title} | text: {content}”; ak nemá názov, použite “title: none”. Úlohy otázok a odpovedí, overovania faktov a vyhľadávania kódu majú vlastné prefixy dopytov. Pri klasifikácii, zhlukovaní či podobnosti viet používajte rovnaký formát úlohy konzistentne na oboch stranách. Príručka všeobecne odporúča nepridávať prefix úlohy do textovej časti kombinovanej multimodálnej reprezentácie.
Štruktúra vstupu určuje, či výsledok reprezentuje jeden kombinovaný objekt alebo samostatné položky. Viacero častí poskytnutých spolu vytvára agregovaný embedding; samostatné objekty Content vytvárajú samostatné embeddingy pre každú položku. Pri príspevku s textom a obrázkom môže kombinovaná reprezentácia zachytiť ich vzťah. Nezávisle vyhľadateľné záznamy ponechajte oddelené. Táto voľba ovplyvňuje podrobnosť vyhľadávania: jeden vektor pre celý príspevok sa líši od jedného pre každú pasáž či obrázok.
Príručka uvádza, že vektory Gemini Embedding 001 a Gemini Embedding 2 zaberajú nekompatibilné priestory a nemožno ich priamo porovnávať. Kolekcia migrovaná zo staršieho modelu potrebuje nové embeddingy pre nový priestor. Výber modelu a rozmery udržujte konzistentné s porovnávanými vektormi a pôvodný text a médiá uchovajte samostatne od číselného indexu. Podobnosť embeddingov je vyhľadávací signál, nie faktické vysvetlenie, prečo dokument odpovedá na otázku používateľa.
Pri praktickom katalógu vytvorte embedding produktovej fotografie spolu so schváleným opisom, keď sa dvojica má vyhľadávať ako jeden objekt. Pri kolekcii dokumentov vytvorte embeddingy zameraných pasáží, porovnajte ich s dopytom formátovaným podľa účelu a potom zobrazte zdrojové pasáže vedľa výsledku vyhľadávania. Pri zvuku alebo videu vyberte úsek opisujúci vyhľadateľnú udalosť a zachovajte jeho pôvodný časový rozsah. Užitočným výstupom je číselná reprezentácia prepojená so zdrojovými dôkazmi pre ďalší vyhľadávací alebo analytický krok aplikácie.
Ailoot Ultra · Embeddingy POST /v1/embeddings google/gemini-embedding-2
google/gemini-embedding-2Úvod
Gemini Embedding 2 mapuje text, obrázky, zvuk, video a PDF do spoločného číselného priestoru. Jeho vektory podporujú vyhľadávanie medzi modalitami, získavanie materiálu, klasifikáciu a zhlukovanie s flexibilnými rozmermi a vstupným limitom 8192 tokenov.
- Povolené vstupy
- Text · token_ids
- Výsledky
- embedding
Dostupné v Ailoot · vstupy a metódy
Ailoot Ultra · Embeddingy POST /v1/embeddings
- Vstup
text,token_ids- Výstup
embedding- Kontext
- 8 192 tokens
- Výstupný formát
- json
| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity google/gemini-embedding-2 | Predvolené— |
Poleinput | Typstring|string[]|integer[]|integer[][] | PožiadavkaPovinné | Hodnoty a limity Minimálny počet položiek: 1 Podmienky: Neprázdna homogénna dávka. ID tokenov sú nezáporné celé čísla. Vstupný rozpočet: Maximum: 8 192 · Textová jednotka: bajty UTF8 · Jednotka tokenov: prvky poľa tokenov | Predvolené— |
Poleencoding_format | Typstring | PožiadavkaVoliteľné | Hodnoty a limity float | Predvolenéfloat |
Poledimensions | Typinteger | PožiadavkaNepodporované | Hodnoty a limity Minimum: 1 | Predvolené— |
Poleuser | Typjson_value | PožiadavkaVoliteľné | Hodnoty a limity Podmienky: Zdroj povoľuje toto pole metadát vo formáte JSON; presný význam na strane dodávateľa sa líši podľa modelu. | Predvolené— |
Polesession_id | Typjson_value | PožiadavkaVoliteľné | Hodnoty a limity Podmienky: Zdroj povoľuje toto pole metadát vo formáte JSON; presný význam na strane dodávateľa sa líši podľa modelu. | Predvolené— |
Poletrace | Typjson_value | PožiadavkaVoliteľné | Hodnoty a limity Podmienky: Zdroj povoľuje toto pole metadát vo formáte JSON; presný význam na strane dodávateľa sa líši podľa modelu. | Predvolené— |
Poleprovider | Typobject | PožiadavkaVoliteľné | Hodnoty a limity Podmienky: provider.options sa odmieta | Predvolené— |
Kombinácie vstupných podkladov
text_to_embedding
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, input |
Parameterinput_shapes | Špecifikáciastring, string[], nonnegative_integer_token_array, nonnegative_integer_token_array[] |
Parameterencoding_format | Špecifikáciafloat |
Parameterdimensions_override | Špecifikáciafalse |
Parametermax_input_budget_units | Špecifikácia8192 |
Parametermultimodal_objects | Špecifikáciafalse |
Parametermaterial_types | Špecifikáciatext, token_ids |
Životný cyklus: synchronous_json
Uchovajte každý index a rozmer vektora.
Názov multimodálneho modelu neznamená, že na tejto konkrétnej trase možno použiť objekty obrázkov.
Cenník
Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.
- Rýchly režim
- Štandardná sadzba Keď je zvolený rýchly režim
- Režim Flex
- Štandardná sadzba Keď je zvolený režim flex
- Maximálna úroveň uvažovania
- Štandardná sadzba Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)
Sadzby Ailoot
Ceny podľa konfigurácie
| Konfigurácia | Sadzobník | Poplatok |
|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Poplatok Vstup · Vstupné tokeny $0.0004 / 1K tokenov Výstup · Výstupné tokeny $0 / 1K tokenov Vstup · Čítanie cache — / 1K tokenov Vstup · Zápis do cache — / 1K tokenov Vstup · Zápis do cache, 1 hod — / 1K tokenov |
Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
Príklady požiadaviek
Ailoot Ultra · Embeddingy
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "google/gemini-embedding-2", "input": ["First document", "Second document"]}')
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/embeddings \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path("result.json").read_text())
for x in r.get("data",[]): print(json.dumps({"index":x.get("index"),"embedding":x.get("embedding")}))
PY_RESULT
from openai import OpenAI
import os
client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
result=client.embeddings.create(model='google/gemini-embedding-2',input=["First document","Second document"])
print(result)
for item in result.data:print(item.index,item.embedding)
Prijať a uložiť výsledky
Ailoot Ultra · Embeddingy
json
Uchovať všetky dokončené výsledky
Uložte každú úplnú vrátenú odpoveď, súbor a časť obsahu.
Uchovajte každý vektor spolu s jeho indexom. Počet vektorov sa musí rovnať počtu vstupov; rozmery musia byť konzistentné.
Ak treba overiť pôvodnú odpoveď
Nezavádza sa žiadny koncový bod pre úlohy tvorby embeddingov.
Polia odpovede
| Pole | Typ |
|---|---|
Poleobject | Typstring |
Polemodel | Typstring |
Poledata[].index | Typinteger |
Poledata[].embedding | Typfinite float[] |
Poleusage | Typobject |
Chyby a ďalšie kroky
| Odpoveď | Podmienka | Ďalší krok |
|---|---|---|
Odpoveď400 · invalid_request_error | PodmienkaNeplatné povinné polia, reprezentácia materiálu alebo hodnota parametra | Ďalší krokPred novou požiadavkou na vytvorenie opravte uvedené polia. |
Aliasy
Aliasy modelov
Ailoot Ultra google/gemini-embedding-2
Aliasy ciest metód
Použite cesty metód uvedené vyššie.
Súvisiace ID na volanie
FAQ · Google: Gemini Embedding 2
- Aké vstupy a výsledky sú dostupné?
POST /v1/embeddings·google/gemini-embedding-2:text,token_ids→embedding- Aké polia používa požiadavka?
POST /v1/embeddings·google/gemini-embedding-2:model,input,encoding_format,provider- Aké limity platia?
POST /v1/embeddings·google/gemini-embedding-2:ctx:8192;input.budget.maximum:8192(bajty UTF8);input.min_items:1