VoyageAI by MongoDB: voyage-4
voyage-4 bäddar in text för generell och flerspråkig informationssökning, med ett gemensamt vektorrum inom Voyage 4-familjen. Den stöder indata på 32 000 token, valbara resultat på 256–2048 dimensioner och query/document-roller för sökning och RAG.
Om modellen
Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.
voyage-4 är Voyage AI:s mellanstora textinbäddningsmodell i Voyage 4-familjen. Den omvandlar fråge- och dokumenttext till numeriska vektorer för generell och flerspråkig informationssökning. Familjens kännetecknande förmåga är ett gemensamt inbäddningsrum: voyage-4, voyage-4-large, voyage-4-lite och voyage-4-nano producerar kompatibla representationer, vilket låter fråge- och dokumentsidorna i en sökuppgift använda olika modeller i familjen.
Gemensamt rum och asymmetrisk sökning
Tillverkaren kallar användning av olika fråge- och korpusmodeller asymmetrisk sökning. Ett dokumenterat mönster är att förbereda korpusen med voyage-4-large och söka i den med frågeinbäddningar från voyage-4. Korpusen bäddas in en gång eller när källmaterialet ändras, medan frågevektorer skapas när sökningar kommer in. Det gemensamma rummet låter modellvalet på frågesidan ändras inom familjen utan att korpusen måste bäddas in igen enbart för bytet.
Håll resultatdimension och representation kompatibla mellan vektorerna som jämförs. Uttalandet om gemensamt rum gäller de namngivna Voyage 4-textmodellerna; det fastställs inte bara av att två obesläktade modeller returnerar arrayer med samma längd. En praktisk uppgift kan därför använda voyage-4 på båda sidor av sökningen eller använda dess frågevektorer med ett befintligt voyage-4-large-dokumentindex när deras representationsinställningar stämmer överens.
Query- och document-roller
För sökning rekommenderar Voyage att ange indatatext som typen query eller document. Indatarollsalternativet ger motsvarande sökinstruktion före vektorisering. Förbered korpuspassager som dokument och användarens sökformulering som en fråga, med den faktiska källtexten och identifierarna bredvid varje lagrad vektor.
Till exempel kan en kunskapssöksamling indexera tekniska instruktioner och produktförklaringar. En fråga om vad som händer efter en misslyckad import bör returnera källpassagen som beskriver beteendet. Bevara rubriker, relevanta villkor och källplatsen tillsammans med passagen så att sökträffen kan granskas eller användas av ett senare RAG-svarssteg. Inbäddningen är den numeriska sökrepresentationen; den underliggande passagen är evidensen i det senare steget.
Dimensioner och resultatdatatyper
Det dokumenterade kontextfönstret per text är 32 000 token. Valbara dimensioner är 256, 512, 1024 och 2048, med 1024 som standard. Matryoshka-inlärning ger dessa nästlade representationsstorlekar. Resultatet kan använda 32-bitars flyttal, 8-bitars heltal med eller utan tecken eller packade binärvärden, möjliggjort av familjens kvantiseringsmedvetna förberedelse.
Med packat binärresultat lagrar varje returnerad byte åtta inbäddningsbitar, så bytelistans längd är en åttondel av den valda dimensionen. Byteantalet och inbäddningsdimensionen har olika betydelser. Välj representationen som ditt sökindex kan tolka och granska kandidatrelevans på frågorna och språken som samlingen faktiskt använder innan en komprimerad konfiguration väljs.
Indatalängd, batchbehandling och kapning
Tillverkarens aktuella textinbäddningsguide tillåter upp till 1000 strängar och 320 000 token totalt i en voyage-4-begäran. Batchutrymmet är separat från fönstret på 32 000 token för varje inmatning. Kapning är aktiverad som standard: För lång text kortas för att passa. Om kapning stängs av ger ett för långt objekt ett fel i stället.
För en lång rapport eller transkription förbereder du medvetet passager som innehåller svar i stället för att förlita dig på ett snitt vid indatagränsen. Håll varje passage kopplad till sitt överordnade dokument och källversion. Vanliga voyage-4-inbäddningsindata är enskilda texter; kontextualiserad behandling av grupper av dokumentdelar hör till de separat dokumenterade kontextuella inbäddningsmodellerna.
Använd sökresultatet
Lagra vektorerna med passagetexten och stabila källidentifierare, jämför varje frågevektor med kompatibla dokumentvektorer och returnera kandidatpassager. Familjeutgåvan utvärderar sökning över material som omfattar tekniska dokument, konversationer, långa dokument, kod, juridik, finans och webbtext. En separat omrankare kan förfina kandidater och ett senare svarssteg kan använda deras text. Bedöm de returnerade passagerna mot uppgiften; kompatibilitet i gemensamt rum möjliggör modellkombinationen, medan nyttan av ett resultat fortfarande beror på källmaterialet och frågan.
Ailoot Ultra · Embeddings POST /v1/embeddings voyageai/voyage-4
voyageai/voyage-4Start
voyage-4 bäddar in text för generell och flerspråkig informationssökning, med ett gemensamt vektorrum inom Voyage 4-familjen. Den stöder indata på 32 000 token, valbara resultat på 256–2048 dimensioner och query/document-roller för sökning och RAG.
- Godkända indata
- Text · token_ids
- Resultat
- embedding
Tillgängligt i Ailoot · indata & metoder
Ailoot Ultra · Embeddings POST /v1/embeddings
- Indatatyper
text,token_ids- Utdatatyper
embedding- Kontext
- 32 000 tokens
- Utdataformat
- json
| Fält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser voyageai/voyage-4 | Standard— |
Fältinput | Typstring|string[]|integer[]|integer[][] | KravObligatoriskt | Värden & gränser Minsta antal objekt: 1 Villkor: En homogen batch som inte är tom. Token-ID:n är heltal som är större än eller lika med noll. Indatabudget: Maximum: 32 000 · Textenhet: UTF8-byte · Tokenenhet: element i en tokenarray | Standard— |
Fältencoding_format | Typstring | KravValfritt | Värden & gränser float | Standardfloat |
Fältdimensions | Typinteger | KravStöds inte | Värden & gränser Minimum: 1 | Standard— |
Fältuser | Typjson_value | KravValfritt | Värden & gränser Villkor: Källan tillåter detta JSON-metadatafält; den exakta innebörden hos leverantören beror på modellen. | Standard— |
Fältsession_id | Typjson_value | KravValfritt | Värden & gränser Villkor: Källan tillåter detta JSON-metadatafält; den exakta innebörden hos leverantören beror på modellen. | Standard— |
Fälttrace | Typjson_value | KravValfritt | Värden & gränser Villkor: Källan tillåter detta JSON-metadatafält; den exakta innebörden hos leverantören beror på modellen. | Standard— |
Fältprovider | Typobject | KravValfritt | Värden & gränser Villkor: provider.options avvisades | Standard— |
Kombinationer av indatamaterial
text_to_embedding
Metodparametrar och livscykel
| Parameter | Avtal |
|---|---|
Parametercontent_type | Avtalapplication/json |
Parameterrequired | Avtalmodel, input |
Parameterinput_shapes | Avtalstring, string[], nonnegative_integer_token_array, nonnegative_integer_token_array[] |
Parameterencoding_format | Avtalfloat |
Parameterdimensions_override | Avtalfalse |
Parametermax_input_budget_units | Avtal32000 |
Parametermultimodal_objects | Avtalfalse |
Parametermaterial_types | Avtaltext, token_ids |
Livscykel: synchronous_json
Behåll varje vektorindex och dimension.
Att modellen har ett multimodalt namn innebär inte att bildobjekt tillåts på just denna anropsväg.
Priser
Tariffuppgifter lägger inte till begäransalternativ. Parametrar som stöds anges för den valda metoden.
- Snabbt läge
- Standardpris När snabbt läge är valt
- Flex-läge
- Standardpris När läget flex är valt
- Högsta resonemangsnivå
- Standardpris När den högsta resonemangsnivån använder standardjusteringen (default)
Ailoot-priser
Priser efter konfiguration
| Konfiguration | Prislista | Avgift |
|---|---|---|
| KonfigurationGrundpriser för token | PrislistaGrundpris | Avgift Indata · Indatatoken $0.00012 / 1K token Utdata · Utdatatoken $0 / 1K token Indata · Cacheläsning — / 1K token Indata · Skrivning till cache — / 1K token Indata · Skrivning till cache, 1 tim — / 1K token |
Ailoot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →
Exempelbegäranden
Ailoot Ultra · Embeddings
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "voyageai/voyage-4", "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='voyageai/voyage-4',input=["First document","Second document"])
print(result)
for item in result.data:print(item.index,item.embedding)
Ta emot och spara resultat
Ailoot Ultra · Embeddings
json
Behåll alla färdiga resultat
Behåll varje fullständigt returnerat svar, fil och innehållsdel.
Behåll varje vektor tillsammans med dess index. Antalet vektorer måste vara lika med antalet indataobjekt; dimensionerna måste vara konsekventa.
Om det ursprungliga svaret behöver kontrolleras
Ingen endpoint för inbäddningsjobb införs.
Svarsfält
| Fält | Typ |
|---|---|
Fältobject | Typstring |
Fältmodel | Typstring |
Fältdata[].index | Typinteger |
Fältdata[].embedding | Typfinite float[] |
Fältusage | Typobject |
Fel och nästa steg
| Svar | Villkor | Nästa steg |
|---|---|---|
Svar400 · invalid_request_error | VillkorOgiltiga obligatoriska fält, ogiltig representation av underlaget eller ogiltigt parametervärde | Nästa stegKorrigera de angivna fälten före en ny begäran om att skapa. |
Alias
Modellalias
Ailoot Ultra voyageai/voyage-4
Alias för metodsökvägar
Använd metodsökvägarna som visas ovan.
Relaterade anropar-ID:n
FAQ · VoyageAI by MongoDB: voyage-4
- Vilka indata och resultat finns?
POST /v1/embeddings·voyageai/voyage-4:text,token_ids→embedding- Vilka fält använder begäran?
POST /v1/embeddings·voyageai/voyage-4:model,input,encoding_format,provider- Vilka gränser gäller?
POST /v1/embeddings·voyageai/voyage-4:ctx:32000;input.budget.maximum:32000(UTF8-byte);input.min_items:1