VoyageAI by MongoDB: voyage-4
voyage-4 koder tekst for generell og flerspråklig gjenfinning, med et felles vektorrom på tvers av Voyage 4-familien. Den støtter inndata på 32 000 tokener, valgbare resultater på 256–2048 dimensjoner og query/document-roller for søk og RAG.
Om modellen
Denne beskrivelsen dekker modellens funksjoner. Tilgjengelige inndata, utdata og alternativer i Ailoot er oppført nedenfor for den valgte metoden.
voyage-4 er Voyage AIs mellomstore tekstembeddingmodell i Voyage 4-familien. Den omdanner forespørsels- og dokumenttekst til numeriske vektorer for generell og flerspråklig gjenfinning. Familiens definerende evne er et felles embeddingrom: voyage-4, voyage-4-large, voyage-4-lite og voyage-4-nano produserer kompatible representasjoner, slik at forespørsels- og dokumentsiden i en søkeoppgave kan bruke ulike modeller i familien.
Felles rom og asymmetrisk gjenfinning
Produsenten kaller bruken av ulike forespørsels- og korpusmodeller asymmetrisk gjenfinning. Et dokumentert mønster er å forberede korpuset med voyage-4-large og søke i det med forespørselsembeddinger fra voyage-4. Embeddingvektorene for korpuset beregnes én gang eller når kildematerialet endres, mens forespørselsvektorer opprettes når søk kommer inn. Det felles rommet lar modellvalget på forespørselssiden endres innenfor familien uten at korpuset må behandles på nytt bare på grunn av dette byttet.
Hold resultatdimensjonen og representasjonen kompatible på tvers av vektorene som sammenlignes. Erklæringen om felles rom gjelder de navngitte Voyage 4-tekstmodellene; den fastslås ikke bare av at to ubeslektede modeller returnerer arrays med samme lengde. En praktisk oppgave kan derfor bruke voyage-4 på begge sider av søket eller bruke forespørselsvektorene med en eksisterende voyage-4-large-dokumentindeks når representasjonsinnstillingene samsvarer.
Query- og document-roller
For gjenfinning anbefaler Voyage å angi inndatateksten som typen query eller document. Valget av inndatarolle gir den tilsvarende gjenfinningsinstruksjonen før vektorisering. Forbered korpuspassasjer som dokumenter og brukerens søkeordlyd som en forespørsel, med den faktiske kildeteksten og identifikatorene ved siden av hver lagret vektor.
En kunnskapssøkesamling kan for eksempel indeksere tekniske instruksjoner og produktforklaringer. En forespørsel om hva som skjer etter en mislykket import, bør returnere kildepassasjen som beskriver adferden. Bevar overskrifter, relevante betingelser og kildeplasseringen med passasjen, slik at søketreffet kan undersøkes eller brukes av et senere RAG-svartrinn. Embeddingvektoren er den numeriske gjenfinningsrepresentasjonen; den underliggende passasjen er evidensen i det senere trinnet.
Dimensjoner og resultatdatatyper
Det dokumenterte kontekstvinduet per tekst er 32 000 tokener. Valgbare dimensjoner er 256, 512, 1024 og 2048, med 1024 som standard. Matryoshka-læring gir disse nestede representasjonsstørrelsene. Resultatet kan bruke 32-biters flyttall, 8-biters heltall med eller uten fortegn eller pakkede binærverdier, muliggjort av familiens kvantiseringsbevisste forberedelse.
Med pakket binærresultat lagrer hver returnerte byte åtte embeddingbiter, så byte-listens lengde er en åttendedel av den valgte dimensjonen. Byteantallet og embeddingdimensjonen har ulike betydninger. Velg representasjonen søkeindeksen kan tolke, og undersøk kandidatrelevans på spørsmålene og språkene samlingen faktisk bruker før du velger en komprimert konfigurasjon.
Inndatalengde, batchbehandling og avkorting
Produsentens gjeldende tekstembeddingveiledning tillater opptil 1000 strenger og 320 000 tokener totalt i en voyage-4-forespørsel. Batchbudsjettet er atskilt fra vinduet på 32 000 tokener for hver inndatatekst. Avkorting er aktivert som standard: For lang tekst forkortes for å få plass. Hvis avkorting deaktiveres, gir et for langt element en feil i stedet.
For en lang rapport eller transkripsjon forbereder du bevisst passasjer som inneholder svar, fremfor å stole på et kutt ved inndatagrensen. Hold hver passasje koblet til det overordnede dokumentet og kildeversjonen. Vanlige voyage-4-embeddinginndata er individuelle tekster; kontekstualisert behandling av grupper med dokumentstykker tilhører de separat dokumenterte kontekstuelle embeddingmodellene.
Bruk gjenfinningsresultatet
Lagre vektorene med passasjeteksten og stabile kildeidentifikatorer, sammenlign hver forespørselsvektor med kompatible dokumentvektorer og returner kandidatpassasjer. Familieutgivelsen vurderer gjenfinning på materiale som inkluderer tekniske dokumenter, samtaler, lange dokumenter, kode, juss, finans og nettekst. En separat reranker kan finjustere kandidatene, og et senere svartrinn kan bruke teksten deres. Vurder de returnerte passasjene mot oppgaven; kompatibilitet i felles rom muliggjør modellkombinasjonen, mens nytten av et resultat fortsatt avhenger av kildematerialet og spørsmålet.
Ailoot Ultra · Vektorrepresentasjoner POST /v1/embeddings voyageai/voyage-4
voyageai/voyage-4Start
voyage-4 koder tekst for generell og flerspråklig gjenfinning, med et felles vektorrom på tvers av Voyage 4-familien. Den støtter inndata på 32 000 tokener, valgbare resultater på 256–2048 dimensjoner og query/document-roller for søk og RAG.
- Godkjente inndata
- Tekst · token_ids
- Resultater
- embedding
Tilgjengelig i Ailoot · inndata & metoder
Ailoot Ultra · Vektorrepresentasjoner POST /v1/embeddings
- Inndatatyper
text,token_ids- Utdatatyper
embedding- Kontekst
- 32 000 tokens
- Utdataformat
- json
| Felt | Type | Krav | Verdier & grenser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrevd | Verdier & grenser voyageai/voyage-4 | Standard— |
Feltinput | Typestring|string[]|integer[]|integer[][] | KravPåkrevd | Verdier & grenser Minste antall elementer: 1 Vilkår: Ikke-tom batch med ensartede elementer. Token-ID-er er ikke-negative heltall. Inndatabudsjett: Maksimum: 32 000 · Tekstenhet: UTF8-byte · Tokenenhet: elementer i token-arrayet | Standard— |
Feltencoding_format | Typestring | KravValgfritt | Verdier & grenser float | Standardfloat |
Feltdimensions | Typeinteger | KravStøttes ikke | Verdier & grenser Minimum: 1 | Standard— |
Feltuser | Typejson_value | KravValgfritt | Verdier & grenser Vilkår: Kilden tillater dette JSON-metadatafeltet; den nøyaktige semantikken hos den underliggende leverandøren er modellavhengig. | Standard— |
Feltsession_id | Typejson_value | KravValgfritt | Verdier & grenser Vilkår: Kilden tillater dette JSON-metadatafeltet; den nøyaktige semantikken hos den underliggende leverandøren er modellavhengig. | Standard— |
Felttrace | Typejson_value | KravValgfritt | Verdier & grenser Vilkår: Kilden tillater dette JSON-metadatafeltet; den nøyaktige semantikken hos den underliggende leverandøren er modellavhengig. | Standard— |
Feltprovider | Typeobject | KravValgfritt | Verdier & grenser Vilkår: provider.options avvises | Standard— |
Kombinasjoner av inngående materialer
text_to_embedding
Metodeparametere og livssyklus
| Parameter | Avtale |
|---|---|
Parametercontent_type | Avtaleapplication/json |
Parameterrequired | Avtalemodel, input |
Parameterinput_shapes | Avtalestring, string[], nonnegative_integer_token_array, nonnegative_integer_token_array[] |
Parameterencoding_format | Avtalefloat |
Parameterdimensions_override | Avtalefalse |
Parametermax_input_budget_units | Avtale32000 |
Parametermultimodal_objects | Avtalefalse |
Parametermaterial_types | Avtaletext, token_ids |
Livssyklus: synchronous_json
Bevar hver vektors indeks og dimensjon.
Et multimodalt modellnavn innebærer ikke at bildeobjekter er tillatt på denne nøyaktige stien.
Priser
Tariffopplysninger legger ikke til forespørselsvalg. Støttede parametere står ved den valgte metoden.
- Hurtigmodus
- Standardpris Når hurtigmodus er valgt
- Flex-modus
- Standardpris Når flex-modus er valgt
- Maksimal resonneringsinnsats
- Standardpris Når justeringen «default» brukes for maksimal resonneringsinnsats
Ailoot-satser
Priser etter konfigurasjon
| Konfigurasjon | Prisplan | Kostnad |
|---|---|---|
| KonfigurasjonGrunnpriser for tokener | PrisplanGrunnsats | Kostnad Inndata · Inngående tokener $0.00012 / 1K tokener Utdata · Utgående tokener $0 / 1K tokener Inndata · Lesing fra hurtigbuffer — / 1K tokener Inndata · Skriving til hurtigbuffer — / 1K tokener Inndata · Skriving til hurtigbuffer, 1 time — / 1K tokener |
Ailoot reserverer et estimert beløp før en forespørsel. Etter resultatet gjøres det endelige beløpet opp basert på målt forbruk. Oppgjør for strømming bruker den endelige forbruksposten. Slik fungerer reservasjon og oppgjør →
Eksempelforespørsler
Ailoot Ultra · Vektorrepresentasjoner
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)
Motta og lagre resultater
Ailoot Ultra · Vektorrepresentasjoner
json
Behold alle ferdige resultater
Behold alle fullstendige returnerte svar, filer og innholdsdeler.
Bevar hver vektor sammen med indeksen. Antall vektorer må være lik antall inndata; dimensjonene må være konsistente.
Hvis det opprinnelige svaret må kontrolleres
Det innføres ikke noe endepunkt for embedding-jobber.
Svarfelter
| Felt | Type |
|---|---|
Feltobject | Typestring |
Feltmodel | Typestring |
Feltdata[].index | Typeinteger |
Feltdata[].embedding | Typefinite float[] |
Feltusage | Typeobject |
Feil og neste trinn
| Svar | Vilkår | Neste trinn |
|---|---|---|
Svar400 · invalid_request_error | VilkårUgyldige påkrevde felter, materialrepresentasjon eller parameterverdi | Neste trinnKorriger de angitte feltene før en ny opprettelsesforespørsel. |
Aliaser
Modellaliaser
Ailoot Ultra voyageai/voyage-4
Aliaser for metodestier
Bruk metodestiene som vises ovenfor.
Tilknyttede anroper-ID-er
FAQ · VoyageAI by MongoDB: voyage-4
- Hvilke inndata og resultater er tilgjengelige?
POST /v1/embeddings·voyageai/voyage-4:text,token_ids→embedding- Hvilke felt bruker forespørselen?
POST /v1/embeddings·voyageai/voyage-4:model,input,encoding_format,provider- Hvilke grenser gjelder?
POST /v1/embeddings·voyageai/voyage-4:ctx:32000;input.budget.maximum:32000(UTF8-byte);input.min_items:1