VoyageAI by MongoDB: voyage-4-large
voyage-4-large est le modèle de plongement textuel à mélange d’experts de Voyage AI pour la recherche généraliste et multilingue. Ses vecteurs partagent l’espace de la famille Voyage 4, ce qui permet de rechercher dans un corpus encodé par Large avec des plongements de requêtes compatibles issus d’autres modèles de la famille.
À propos du modèle
Cette description présente les capacités du modèle. Les entrées, sorties et options disponibles dans Ailoot pour la méthode sélectionnée figurent ci-dessous.
voyage-4-large est le modèle phare de plongement textuel de Voyage AI dans la famille Voyage 4. Il représente les passages sources et les requêtes sous forme de vecteurs numériques pour la recherche généraliste et multilingue. Ses deux caractéristiques distinctives sont une conception à mélange d’experts et l’espace de plongement partagé utilisé par voyage-4-large, voyage-4, voyage-4-lite et voyage-4-nano.
Espace partagé : des choix séparés pour le corpus et les requêtes
Le fabricant décrit une recherche asymétrique : les documents peuvent être encodés avec voyage-4-large, tandis qu’un autre modèle de la famille Voyage 4 prépare les vecteurs de requêtes. Par exemple, un corpus représenté par Large peut être interrogé avec des requêtes voyage-4. Cela permet aux deux côtés de la recherche de choisir des modèles différents tout en restant dans l’espace compatible documenté.
Une collection concrète peut donc utiliser Large pour préparer des passages documentaires stables et choisir indépendamment le modèle du côté des requêtes. Les documents sont encodés lorsque le corpus est créé ou mis à jour, tandis que les requêtes sont vectorisées au fil des recherches des utilisateurs. L’annonce de la famille décrit le changement de modèle de requête au sein de la famille compatible sans revectoriser le corpus documentaire uniquement pour ce changement. Gardez les vecteurs comparés à des dimensions correspondantes et dans des représentations que le système de recherche peut interpréter ensemble.
Conception du plongement à mélange d’experts
Une couche dense feed-forward traite chaque token au moyen de l’ensemble de ses paramètres. L’approche MoE décrite pour voyage-4-large utilise un routeur et des réseaux feed-forward d’experts, en sélectionnant les experts qui traitent chaque token. Cela sépare la capacité totale du modèle des paramètres actifs pour un token particulier. Voyage rapporte un ratio d’activation de 1/10 pour la conception MoE du modèle, avec un routage top-k.
L’explication technique du fabricant décrit aussi deux choix de développement. La capacité des experts influe sur le fait que des tokens excédentaires contournent une couche d’experts par une voie résiduelle ; l’équipe a choisi le plus grand facteur de capacité réalisable afin d’éviter une perte de qualité de recherche. À l’étape finale d’entraînement, les paramètres du routeur sont gelés avant la fusion des modèles, afin que l’interpolation des modèles sources ne modifie pas le routage appris de sélection des experts. Il s’agit de caractéristiques de préparation du modèle, distinctes des réglages de longueur textuelle ou de troncature utilisés lors de la préparation d’une entrée.
Dimensions et représentation de sortie
Le tableau officiel des modèles spécifie une fenêtre de contexte de 32 000 tokens et des plongements sélectionnables de 256, 512, 1024 et 2048 dimensions, avec 1024 par défaut. La famille utilise l’apprentissage Matryoshka pour des tailles de représentation imbriquées et prend en charge plusieurs choix de quantification : virgule flottante de 32 bits, entiers signés ou non signés de 8 bits et sortie binaire compactée.
Avec une sortie binaire, la longueur de la liste d’octets renvoyée est égale au huitième de la dimension sélectionnée, car chaque octet contient huit bits de plongement. Préservez les choix de dimension et de type de données avec l’index et utilisez une méthode de comparaison prenant en charge cette représentation. Un vecteur plus petit ou compressé modifie la représentation utilisée pour la recherche ; évaluez les passages pertinents renvoyés pour de vraies questions avant de le choisir pour une collection.
Préparer les entrées de documents et de requêtes
Voyage recommande le rôle document pour les passages du corpus et le rôle query pour les formulations de recherche. Son option de rôle ajoute l’instruction de recherche correspondante avant l’encodage. Préservez le titre utile, les conditions et l’emplacement source du passage, puis stockez le vecteur renvoyé avec le texte d’origine et un identifiant stable.
Pour une collection de connaissances techniques, une question sur un mode de défaillance doit mener au passage qui décrit ce mode et ses conditions pertinentes. Pour une collection documentaire multilingue, conservez la langue source et évaluez les questions et la terminologie utilisées lors des recherches. La publication couvre des matériaux de recherche comprenant des documents techniques, des conversations, de longs documents, du code, du droit, de la finance et du texte web. Le plongement trouve des matériaux candidats ; un reclasseur ou une étape de réponse ultérieurs utilisent le texte d’origine.
Limites de contexte, de traitement par lots et de troncature
Le guide actuel du fabricant autorise jusqu’à 1000 chaînes et 120 000 tokens d’entrée au total dans une requête voyage-4-large. Cela diffère du budget par lot indiqué pour voyage-4, tandis que les deux possèdent une fenêtre de 32 000 tokens par texte. La troncature par défaut raccourcit une entrée trop longue pour la faire tenir ; désactiver la troncature renvoie une erreur pour un texte trop long.
Choisissez délibérément les limites des passages contenant des réponses, afin qu’une longue source ne perde pas une précision pertinente dans une fin tronquée. Gardez l’association à la source lors du renvoi des résultats de recherche et examinez le texte candidat réel, plutôt que de traiter la proximité vectorielle comme une vérification de son contenu. La compatibilité d’espace partagé s’applique à la famille textuelle Voyage 4 documentée ; le traitement contextualisé des segments, les plongements d’images ou de vidéos et les éditions ultérieures de modèles restent des processus propres à chaque modèle.
Ailoot Ultra · Embeddings POST /v1/embeddings voyageai/voyage-4-large
voyageai/voyage-4-largePour commencer
voyage-4-large est le modèle de plongement textuel à mélange d’experts de Voyage AI pour la recherche généraliste et multilingue. Ses vecteurs partagent l’espace de la famille Voyage 4, ce qui permet de rechercher dans un corpus encodé par Large avec des plongements de requêtes compatibles issus d’autres modèles de la famille.
- Entrées acceptées
- Texte · token_ids
- Résultats
- embedding
Disponible dans Ailoot · entrées et méthodes
Ailoot Ultra · Embeddings POST /v1/embeddings
- Entrée
text,token_ids- Sortie
embedding- Contexte
- 32 000 tokens
- Format de sortie
- json
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites voyageai/voyage-4-large | Par défaut— |
Champinput | Typestring|string[]|integer[]|integer[][] | ExigenceObligatoire | Valeurs et limites Nombre minimal d’éléments: 1 Conditions: Lot homogène non vide. Les identifiants de jetons sont des entiers positifs ou nuls. Budget d’entrée : Maximum: 32 000 · Unité de texte: octets UTF8 · Unité de jetons: éléments du tableau de jetons | Par défaut— |
Champencoding_format | Typestring | ExigenceFacultatif | Valeurs et limites float | Par défautfloat |
Champdimensions | Typeinteger | ExigenceNon pris en charge | Valeurs et limites Minimum: 1 | Par défaut— |
Champuser | Typejson_value | ExigenceFacultatif | Valeurs et limites Conditions: Le code source autorise ce champ de métadonnées JSON ; sa sémantique exacte en amont dépend du modèle. | Par défaut— |
Champsession_id | Typejson_value | ExigenceFacultatif | Valeurs et limites Conditions: Le code source autorise ce champ de métadonnées JSON ; sa sémantique exacte en amont dépend du modèle. | Par défaut— |
Champtrace | Typejson_value | ExigenceFacultatif | Valeurs et limites Conditions: Le code source autorise ce champ de métadonnées JSON ; sa sémantique exacte en amont dépend du modèle. | Par défaut— |
Champprovider | Typeobject | ExigenceFacultatif | Valeurs et limites Conditions: provider.options est refusé | Par défaut— |
Combinaisons d’éléments d’entrée
text_to_embedding
Paramètres et cycle de vie de la méthode
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, input |
Paramètreinput_shapes | Contratstring, string[], nonnegative_integer_token_array, nonnegative_integer_token_array[] |
Paramètreencoding_format | Contratfloat |
Paramètredimensions_override | Contratfalse |
Paramètremax_input_budget_units | Contrat32000 |
Paramètremultimodal_objects | Contratfalse |
Paramètrematerial_types | Contrattext, token_ids |
Cycle de vie : synchronous_json
Conservez tous les indices et toutes les dimensions des vecteurs.
Un nom de modèle multimodal n’autorise pas les objets image sur ce chemin précis.
Tarifs
Les tarifs n’ajoutent pas d’options de requête. Les paramètres pris en charge figurent dans la méthode sélectionnée.
- Mode rapide
- Tarif standard Lorsque le mode rapide est sélectionné
- Mode Flex
- Tarif standard Lorsque le mode flex est sélectionné
- Effort de raisonnement maximal
- Tarif standard Lorsque l’effort de raisonnement maximal utilise l’ajustement par défaut (default)
Tarifs Ailoot
Prix par configuration
| Configuration | Barème tarifaire | Coût |
|---|---|---|
| ConfigurationTarifs de base des jetons | Barème tarifaireTarif de base | Coût Entrée · Jetons en entrée $0.00024 / 1K jetons Sortie · Jetons en sortie $0 / 1K jetons Entrée · Lecture du cache — / 1K jetons Entrée · Écriture dans le cache — / 1K jetons Entrée · Écriture dans le cache, 1 h — / 1K jetons |
Ailoot réserve un montant estimé avant une requête. Après le résultat, le montant final est débité selon l’utilisation mesurée. Pour le streaming, le montant final à débiter est calculé à partir du relevé final d’utilisation. Fonctionnement de la réservation et du débit →
Exemples de requêtes
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)
Recevoir et enregistrer les résultats
Ailoot Ultra · Embeddings
json
Conserver tous les résultats terminés
Conservez chaque réponse, fichier et partie de contenu renvoyés dans leur intégralité.
Conservez chaque vecteur avec son indice. Le nombre de vecteurs doit être égal au nombre d’entrées ; les dimensions doivent être cohérentes.
Si la réponse d’origine doit être vérifiée
Aucun point de terminaison dédié aux tâches d’embedding n’est ajouté.
Champs de la réponse
| Champ | Type |
|---|---|
Champobject | Typestring |
Champmodel | Typestring |
Champdata[].index | Typeinteger |
Champdata[].embedding | Typefinite float[] |
Champusage | Typeobject |
Erreurs et étapes suivantes
| Réponse | Condition | Étape suivante |
|---|---|---|
Réponse400 · invalid_request_error | ConditionChamps obligatoires, représentation des éléments fournis ou valeur de paramètre invalides | Étape suivanteCorrigez les champs indiqués avant une nouvelle requête de création. |
Alias
Alias du modèle
Ailoot Ultra voyageai/voyage-4-large
Alias des chemins de méthode
Utilisez les chemins de méthode indiqués ci-dessus.
ID d’appel associés
FAQ · VoyageAI by MongoDB: voyage-4-large
- Quelles entrées et quels résultats sont disponibles ?
POST /v1/embeddings·voyageai/voyage-4-large:text,token_ids→embedding- Quels champs la requête utilise-t-elle ?
POST /v1/embeddings·voyageai/voyage-4-large:model,input,encoding_format,provider- Quelles limites s’appliquent ?
POST /v1/embeddings·voyageai/voyage-4-large:ctx:32000;input.budget.maximum:32000(octets UTF8);input.min_items:1