VoyageAI by MongoDB: voyage-4-large
voyage-4-large ist das Mixture-of-Experts-Text-Embedding-Modell von Voyage AI für allgemeine und mehrsprachige Informationssuche. Seine Vektoren teilen den Raum der Voyage-4-Familie, sodass Korpus-Embeddings von Large mit kompatiblen Anfrage-Embeddings anderer Familienmodelle durchsucht werden können.
Über das Modell
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
voyage-4-large ist das führende Text-Embedding-Modell von Voyage AI in der Voyage-4-Familie. Es stellt Quellpassagen und Abfragen als numerische Vektoren für allgemeine und mehrsprachige Suche dar. Seine beiden besonderen Merkmale sind ein Mixture-of-Experts-Modellaufbau und der gemeinsame Embedding-Raum von voyage-4-large, voyage-4, voyage-4-lite und voyage-4-nano.
Gemeinsamer Raum: getrennte Modellauswahl für Korpus und Abfragen
Der Hersteller beschreibt asymmetrische Suche: Dokumente können mit voyage-4-large eingebettet werden, während ein anderes Modell der Voyage-4-Familie die Abfragevektoren vorbereitet. Ein mit Large dargestellter Korpus kann beispielsweise mit Abfragen von voyage-4 durchsucht werden. So können beide Seiten der Suche unterschiedliche Modelle verwenden und zugleich im dokumentierten kompatiblen Raum bleiben.
Eine praktische Sammlung kann daher Large zur Aufbereitung beständiger Dokumentpassagen verwenden und das Modell auf der Abfrageseite unabhängig wählen. Dokumente werden beim Erstellen oder Aktualisieren des Korpus eingebettet, während Abfragen bei der Suche durch Nutzer vektorisiert werden. Die Familienankündigung beschreibt den Wechsel des Abfragemodells innerhalb der kompatiblen Familie, ohne allein deswegen den Dokumentkorpus erneut zu vektorisieren. Halten Sie verglichene Vektoren in übereinstimmenden Dimensionen und Darstellungen, die das Suchsystem gemeinsam verarbeiten kann.
Mixture-of-Experts-Aufbau für Embeddings
Eine dichte Feedforward-Schicht verarbeitet jedes Token mit ihrem vollständigen Parametersatz. Der für voyage-4-large beschriebene MoE-Ansatz verwendet einen Router und Experten-Feedforward-Netze und wählt die Experten aus, die jedes Token verarbeiten. Dadurch wird die gesamte Modellkapazität von den für ein bestimmtes Token aktiven Parametern getrennt. Voyage nennt für den MoE-Aufbau des Modells ein Aktivierungsverhältnis von 1/10 mit top-k-Routing.
Die technische Erklärung des Herstellers beschreibt ausserdem zwei Entwicklungsentscheidungen. Die Expertenkapazität beeinflusst, ob überzählige Token eine Expertenschicht über einen Residualpfad umgehen; das Team wählte den grösstmöglichen umsetzbaren Kapazitätsfaktor, um Verluste bei der Suchqualität zu vermeiden. In der letzten Trainingsphase werden die Routerparameter vor dem Zusammenführen der Modelle eingefroren, damit die Interpolation der Quellmodelle das erlernte Routing zur Expertenauswahl nicht verändert. Dies sind Merkmale der Modellvorbereitung, getrennt von den Textlängen- oder Kürzungseinstellungen bei der Eingabeaufbereitung.
Dimensionen und Ausgabedarstellung
Die offizielle Modelltabelle nennt ein Kontextfenster von 32’000 Token und wählbare Embeddings mit 256, 512, 1024 und 2048 Dimensionen; 1024 ist der Standard. Die Familie verwendet Matryoshka-Lernen für verschachtelte Darstellungsgrössen und unterstützt verschiedene Quantisierungen: 32-Bit-Gleitkommazahlen, vorzeichenbehaftete oder vorzeichenlose 8-Bit-Ganzzahlen und gepackte binäre Ausgabe.
Bei binärer Ausgabe ist die zurückgegebene Byteliste ein Achtel so lang wie die gewählte Dimension, weil jedes Byte acht Embedding-Bits enthält. Bewahren Sie Dimension und Datentyp zusammen mit dem Index auf und verwenden Sie eine Vergleichsmethode, die diese Darstellung unterstützt. Ein kleinerer oder komprimierter Vektor verändert die für die Suche verwendete Darstellung; bewerten Sie die zu tatsächlichen Fragen zurückgegebenen relevanten Passagen, bevor Sie ihn für eine Sammlung wählen.
Bereiten Sie Dokument- und Abfrageeingaben vor
Voyage empfiehlt die Rolle document für Korpuspassagen und die Rolle query für Suchformulierungen. Die Rollenoption fügt vor dem Einbetten die entsprechende Suchanweisung hinzu. Bewahren Sie die hilfreiche Überschrift, Bedingungen und Quellenstelle einer Passage und speichern Sie den zurückgegebenen Vektor zusammen mit dem Originaltext und einer stabilen Kennung.
In einer technischen Wissenssammlung sollte eine Frage zu einem Fehlermodus zur Passage führen, die diesen Modus und seine relevanten Bedingungen beschreibt. Bewahren Sie bei einer sprachübergreifenden Dokumentsammlung die Quellsprache auf und bewerten Sie die Fragen und Begriffe, nach denen Nutzer suchen werden. Die Veröffentlichung deckt Suchmaterial wie technische Dokumente, Gespräche, lange Dokumente, Code, Recht, Finanzen und Webtexte ab. Das Embedding findet mögliche relevante Inhalte; ein späterer Reranker oder Antwortschritt verwendet den Originaltext.
Grenzen für Kontext, Bündelung und Kürzung
Der aktuelle Leitfaden des Herstellers erlaubt bis zu 1’000 Zeichenketten und insgesamt 120’000 Eingabetoken in einer Anfrage an voyage-4-large. Dies unterscheidet sich vom angegebenen Bündelumfang für voyage-4, während beide ein Fenster von 32’000 Token je Text haben. Die standardmässige Kürzung verkürzt eine zu lange Eingabe auf die passende Länge; bei deaktivierter Kürzung führt ein zu langer Text zu einem Fehler.
Wählen Sie die Grenzen antworttragender Passagen bewusst, damit eine lange Quelle keine relevante Einschränkung an einem abgeschnittenen Ende verliert. Bewahren Sie die Quellenzuordnung bei der Rückgabe von Suchergebnissen und prüfen Sie den tatsächlichen Kandidatentext, statt Vektornähe als Bestätigung seines Inhalts zu behandeln. Die Kompatibilität des gemeinsamen Raums gilt für die dokumentierte Voyage-4-Textfamilie; kontextualisierte Abschnittsverarbeitung, Bild- und Video-Embeddings sowie spätere Modelleditionen bleiben eigene modellspezifische Abläufe.
Ailoot Ultra · Embeddings POST /v1/embeddings voyageai/voyage-4-large
voyageai/voyage-4-largeEinstieg
voyage-4-large ist das Mixture-of-Experts-Text-Embedding-Modell von Voyage AI für allgemeine und mehrsprachige Informationssuche. Seine Vektoren teilen den Raum der Voyage-4-Familie, sodass Korpus-Embeddings von Large mit kompatiblen Anfrage-Embeddings anderer Familienmodelle durchsucht werden können.
- Zulässige Eingaben
- Text · token_ids
- Ergebnisse
- embedding
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Embeddings POST /v1/embeddings
- Eingabe
text,token_ids- Ausgabe
embedding- Kontext
- 32'000 tokens
- Ausgabeformat
- json
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits voyageai/voyage-4-large | Standard— |
Feldinput | Typstring|string[]|integer[]|integer[][] | AnforderungErforderlich | Werte und Limits Mindestanzahl Elemente: 1 Bedingungen: Nicht leerer, homogener Batch. Token-IDs sind nichtnegative Ganzzahlen. Eingabebudget: Maximum: 32'000 · Texteinheit: UTF8-Bytes · Tokeneinheit: Elemente des Token-Arrays | Standard— |
Feldencoding_format | Typstring | AnforderungOptional | Werte und Limits float | Standardfloat |
Felddimensions | Typinteger | AnforderungNicht unterstützt | Werte und Limits Minimum: 1 | Standard— |
Felduser | Typjson_value | AnforderungOptional | Werte und Limits Bedingungen: Der Quellcode erlaubt dieses JSON-Metadatenfeld; die genaue Semantik beim vorgelagerten Anbieter ist modellspezifisch. | Standard— |
Feldsession_id | Typjson_value | AnforderungOptional | Werte und Limits Bedingungen: Der Quellcode erlaubt dieses JSON-Metadatenfeld; die genaue Semantik beim vorgelagerten Anbieter ist modellspezifisch. | Standard— |
Feldtrace | Typjson_value | AnforderungOptional | Werte und Limits Bedingungen: Der Quellcode erlaubt dieses JSON-Metadatenfeld; die genaue Semantik beim vorgelagerten Anbieter ist modellspezifisch. | Standard— |
Feldprovider | Typobject | AnforderungOptional | Werte und Limits Bedingungen: provider.options abgelehnt | Standard— |
Kombinationen von Eingabematerialien
text_to_embedding
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, input |
Parameterinput_shapes | Vertragstring, string[], nonnegative_integer_token_array, nonnegative_integer_token_array[] |
Parameterencoding_format | Vertragfloat |
Parameterdimensions_override | Vertragfalse |
Parametermax_input_budget_units | Vertrag32000 |
Parametermultimodal_objects | Vertragfalse |
Parametermaterial_types | Vertragtext, token_ids |
Lebenszyklus: synchronous_json
Jeden Vektorindex und jede Dimension beibehalten.
Ein multimodaler Modellname erlaubt auf genau diesem Pfad keine Bildobjekte.
Tarife
Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.
- Schnellmodus
- Standardtarif Wenn der Schnellmodus ausgewählt ist
- Flex-Modus
- Standardtarif Wenn der Modus flex ausgewählt ist
- Maximaler Denkaufwand
- Standardtarif Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird
Ailoot-Tarife
Preise nach Konfiguration
| Konfiguration | Tarifstaffel | Gebühr |
|---|---|---|
| KonfigurationBasistarife für Token | TarifstaffelGrundtarif | Gebühr Eingabe · Eingabetoken $0.00024 / 1K Tokens Ausgabe · Ausgabetoken $0 / 1K Tokens Eingabe · Cache lesen — / 1K Tokens Eingabe · Cache schreiben — / 1K Tokens Eingabe · Cache schreiben, 1 Stunde — / 1K Tokens |
Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschliessenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Beispielanfragen
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-large", "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-large',input=["First document","Second document"])
print(result)
for item in result.data:print(item.index,item.embedding)
Ergebnisse abrufen und speichern
Ailoot Ultra · Embeddings
json
Alle fertiggestellten Ergebnisse aufbewahren
Bewahren Sie jede vollständig zurückgegebene Antwort, Datei und jeden Inhaltsteil auf.
Jeden Vektor mit seinem Index beibehalten. Die Anzahl der Vektoren muss der Anzahl der Eingaben entsprechen; die Dimensionen müssen konsistent sein.
Wenn die ursprüngliche Antwort geprüft werden muss
Es wird kein Endpunkt für Embedding-Aufträge eingeführt.
Antwortfelder
| Feld | Typ |
|---|---|
Feldobject | Typstring |
Feldmodel | Typstring |
Felddata[].index | Typinteger |
Felddata[].embedding | Typfinite float[] |
Feldusage | Typobject |
Fehler und nächste Schritte
| Antwort | Bedingung | Nächster Schritt |
|---|---|---|
Antwort400 · invalid_request_error | BedingungPflichtfelder, Darstellung des Eingabematerials oder Parameterwert ungültig | Nächster SchrittDie angegebenen Felder vor einer neuen Erstellungsanfrage korrigieren. |
Aliasnamen
Modellaliasnamen
Ailoot Ultra voyageai/voyage-4-large
Aliasnamen für Methodenpfade
Verwenden Sie die oben angezeigten Methodenpfade.
Zugehörige Aufrufer-IDs
FAQ · VoyageAI by MongoDB: voyage-4-large
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/embeddings·voyageai/voyage-4-large:text,token_ids→embedding- Welche Felder verwendet die Anfrage?
POST /v1/embeddings·voyageai/voyage-4-large:model,input,encoding_format,provider- Welche Grenzen gelten?
POST /v1/embeddings·voyageai/voyage-4-large:ctx:32000;input.budget.maximum:32000(UTF8-Bytes);input.min_items:1