VoyageAI by MongoDB: voyage-4-lite
Voyage AI voyage-4-lite est l’édition de plongement textuel conçue pour limiter la latence dans la famille Voyage 4. Elle prend en charge des entrées de 32 000 tokens, quatre tailles de vecteurs et des représentations quantifiées, avec un espace de plongement partagé compatible avec les autres modèles textuels Voyage 4.
À 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-lite est le modèle de plongement textuel conçu pour limiter la latence dans la famille Voyage 4 de Voyage AI. Il représente les requêtes et les documents sous forme de vecteurs numériques pour la recherche d’information généraliste. Sa particularité familiale est un espace de plongement partagé avec voyage-4, voyage-4-large et voyage-4-nano, permettant de choisir séparément les modèles de requête et de document.
Commencer par les rôles de recherche
Préparez le besoin d’information de l’utilisateur comme une requête et le matériau interrogeable comme des documents. Voyage recommande les types d’entrée query/document pour la recherche ; sa recette publiée ajoute l’instruction de recherche correspondante lors de la vectorisation du texte.
Pour une collection de manuels du personnel, une requête sur le report des congés non utilisés à la période suivante doit être comparée aux sections précises de la politique. Gardez la règle, ses conditions et toute exception pertinente dans le passage indexé. Conservez le document d’origine et l’identifiant de section avec le vecteur, afin que l’application puisse renvoyer le texte réel de la politique.
Un type d’entrée non spécifié représente directement le texte, tandis que les rôles query/document l’adaptent à la recherche. Le fabricant indique que les plongements produits avec et sans ces réglages de rôle sont compatibles, mais conserver une politique de préparation cohérente facilite l’évaluation de la collection.
Espace partagé dans la famille textuelle Voyage 4
Voyage documente explicitement un processus de recherche asymétrique : les documents peuvent être encodés avec voyage-4-large et recherchés au moyen de vecteurs de requêtes issus de voyage-4-lite. Il s’agit d’une déclaration de compatibilité au niveau de la famille, plutôt que d’une conclusion tirée du fait que deux modèles renvoient la même longueur vectorielle.
Gardez la dimension vectorielle et la représentation choisies alignées entre la collection et le côté des requêtes. L’espace partagé permet aussi de changer le modèle de requête au sein de cette famille textuelle nommée Voyage 4 sans revectoriser les documents existants. Évaluez le classement obtenu à partir de questions représentatives lorsque vous choisissez l’édition de requête.
Le rôle de l’édition Lite est d’être l’option plus petite de requête et de plongement textuel, centrée sur la latence. Le fabricant attribue l’architecture à mélange d’experts spécifiquement à voyage-4-large ; le nom de la famille n’établit pas cette architecture pour Lite.
Contexte, dimensions et format du résultat
La longueur de contexte publiée est de 32 000 tokens par texte. Le vecteur par défaut possède 1024 dimensions, avec 256, 512 et 2048 également disponibles grâce à l’apprentissage Matryoshka. Le processus de plongement textuel du fabricant documente des représentations à virgule flottante, en entiers signés et non signés de 8 bits, et binaires à bits compactés pour voyage-4-lite.
Pour les vecteurs standards à virgule flottante, les recommandations de similarité de Voyage décrivent des plongements de norme unitaire, ce qui rend équivalentes les similarités cosinus et par produit scalaire. Les formes quantifiées nécessitent la gestion de représentation correspondante. Par exemple, une liste binaire à bits compactés stocke huit bits de plongement dans chaque octet ; sa longueur de liste diffère de la dimension vectorielle sémantique.
Dans la recette de traitement par lots documentée de Voyage, une liste contient au maximum 1000 textes et un million de tokens au total pour cette édition Lite exacte. Le comportement par défaut en cas de longueur excessive tronque chaque texte à la limite du contexte ; l’autre réglage rejette les entrées trop longues. Ces limites par lot et par texte sont distinctes.
Préparer et examiner les résultats de recherche
Divisez les sources longues en sections cohérentes pouvant être renvoyées comme éléments à examiner. Un contexte de 32 000 tokens autorise une entrée longue, mais une unité de recherche utile doit toujours mener à la section source pertinente. Incluez le titre ou le détail d’identification nécessaires à l’interprétation d’une règle.
Pour le RAG, retrouvez les sections candidates et transmettez leur texte d’origine à l’étape de rédaction de la réponse avec leurs associations sources. Le modèle de plongement produit des vecteurs et ne génère pas de réponse sur la politique. La similarité classe les candidats selon le modèle et la configuration de comparaison choisis ; examinez le passage réel pour la condition précise demandée.
La combinaison utile propre à voyage-4-lite associe un modèle textuel centré sur la latence, des représentations flexibles, un contexte de 32 000 tokens et une compatibilité documentée dans la famille textuelle Voyage 4. Gardez ces propriétés avec la collection indexée et utilisez les résultats de recherche liés à leurs sources pour aider l’application environnante.
Ailoot Ultra · Embeddings POST /v1/embeddings voyageai/voyage-4-lite
voyageai/voyage-4-litePremiers pas
Voyage AI voyage-4-lite est l’édition de plongement textuel conçue pour limiter la latence dans la famille Voyage 4. Elle prend en charge des entrées de 32 000 tokens, quatre tailles de vecteurs et des représentations quantifiées, avec un espace de plongement partagé compatible avec les autres modèles textuels Voyage 4.
- Entrées acceptées
- Texte · token_ids
- Résultats
- embedding
Disponible dans Ailoot · entrées et méthodes
Ailoot Ultra · Embeddings POST /v1/embeddings
- Types d’entrée
text,token_ids- Types de 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-lite | 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 tokens: éléments du tableau de tokens | 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: 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: 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: 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 tokens | Barème tarifaireTarif de base | Coût Entrée · Tokens en entrée $0.00004 / 1K tokens Sortie · Tokens en sortie $0 / 1K tokens Entrée · Lecture du cache — / 1K tokens Entrée · Écriture dans le cache — / 1K tokens Entrée · Écriture dans le cache, 1 h — / 1K tokens |
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-lite", "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-lite',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 contenus ou valeur de paramètre non valides | Étape suivanteCorrigez les champs indiqués avant une nouvelle requête de création. |
Alias
Alias du modèle
Ailoot Ultra voyageai/voyage-4-lite
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-lite
- Quelles entrées et quels résultats sont disponibles ?
POST /v1/embeddings·voyageai/voyage-4-lite:text,token_ids→embedding- Quels champs la requête utilise-t-elle ?
POST /v1/embeddings·voyageai/voyage-4-lite:model,input,encoding_format,provider- Quelles limites s’appliquent ?
POST /v1/embeddings·voyageai/voyage-4-lite:ctx:32000;input.budget.maximum:32000(octets UTF8);input.min_items:1