BAAI: bge-large-en-v1.5
BAAI bge-large-en-v1.5 produit des vecteurs de texte anglais de 1024 dimensions pour la recherche d’information et la comparaison sémantique. Sa préparation v1.5 permet une instruction de requête facultative, avec une longueur de séquence documentée de 512 tokens.
À 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.
bge-large-en-v1.5 est l’édition anglaise Large d’embeddings denses de BAAI. Elle transforme un texte en un vecteur à 1024 dimensions pour la recherche de passages et la comparaison sémantique. La version 1.5 est l’évolution du fabricant visant une distribution de similarité plus utile et une meilleure recherche sans consigne. Large reste un checkpoint distinct de Base, Small, des éditions chinoises et du modèle multilingue BGE-M3.
Mettre en place la recherche de passages
Pour une courte requête de recherche portant sur des documents plus longs, le fabricant recommande la consigne de requête « Represent this sentence for searching relevant passages: ». Ajoutez-la du côté de la requête ; les passages du corpus conservent leur texte source sans cette consigne. Pour les autres usages, le texte direct suffit. BAAI documente également la recherche sans préfixe dans la version v1.5 et recommande de choisir la préparation la plus efficace pour la tâche réelle.
Un ensemble de connaissances pratique peut indexer les sections d’un manuel technique anglais. Une question sur le réglage modifiant le format de sortie doit renvoyer la section expliquant ce réglage et ses conditions. Conservez le titre, l’explication pertinente et l’emplacement source avec chaque passage. Le modèle fournit la représentation numérique ; le texte source renvoyé est ce qu’un lecteur ou une étape RAG ultérieure utilise.
Représentation et correspondance
L’exemple d’encodage direct du fabricant utilise le dernier état caché du premier token CLS comme embedding agrégé, puis normalise le vecteur. Comparer des vecteurs normalisés par produit scalaire donne la similarité cosinus. Chaque passage peut donc être préparé une fois et enregistré pour être comparé aux vecteurs des requêtes entrantes, tandis que les sources modifiées reçoivent une représentation mise à jour.
Les 1024 dimensions définissent la longueur du vecteur de sortie. Elles diffèrent de la représentation Base à 768 dimensions et n’établissent pas un espace partagé compatible avec un autre checkpoint. Associez le modèle et la convention de préparation à l’index enregistré. Un changement d’édition d’embeddings nécessite de vérifier ensemble les représentations du corpus et des requêtes.
Faire tenir la source dans la fenêtre
La longueur de séquence documentée est de 512 tokens. Préparez un long manuel sous forme de sections cohérentes plutôt que d’une entrée unique trop volumineuse. Gardez une condition ou exception auprès de la règle qu’elle précise, et incluez assez de contexte pour qu’une section retrouvée soit compréhensible isolément. Une consigne de requête ajoutée occupe elle aussi des tokens d’entrée ; la fenêtre du modèle concerne donc l’entrée préparée complète.
Une délimitation de passage utile peut inclure un titre et les paragraphes répondant à une question utilisateur. Conservez l’identifiant et la version du document parent en dehors du vecteur afin de pouvoir relier un résultat à la bonne source. Pour une comparaison, utilisez les textes réels à comparer plutôt que de les remplacer par des résumés sans rapport qui supprimeraient la distinction recherchée.
Interpréter le score
Le fabricant avertit de ne pas considérer la similarité absolue comme une règle universelle d’équivalence sémantique. L’ordre relatif des scores est central pour la recherche, et un seuil doit être calibré sur la distribution des textes propres à la tâche. Examinez les passages proposés pour des questions dont la réponse est connue et pour celles dont la réponse est absente. Cela révèle si une section renvoyée fournit les informations requises plutôt que de simplement ressembler au sujet.
bge-large-en-v1.5 fournit des vecteurs denses anglais. Un reranker distinct peut affiner l’ordre des propositions, et un modèle linguistique distinct peut composer une réponse à partir des passages sélectionnés. La sortie utile de cette édition est une représentation interrogeable liée à son texte source, avec le choix exact du modèle Large v1.5 et la préparation des entrées conservés.
Ailoot Ultra · Embeddings POST /v1/embeddings baai/bge-large-en-v1.5
baai/bge-large-en-v1.5Premiers pas
BAAI bge-large-en-v1.5 produit des vecteurs de texte anglais de 1024 dimensions pour la recherche d’information et la comparaison sémantique. Sa préparation v1.5 permet une instruction de requête facultative, avec une longueur de séquence documentée de 512 tokens.
- 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- Format de sortie
- json
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites baai/bge-large-en-v1.5 | 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: 512 · 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: 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 | Contrat512 |
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
- Non précisé Lorsque le mode rapide est sélectionné
- Mode Flex
- Non précisé Lorsque le mode flex est sélectionné
- Effort de raisonnement maximal
- Non précisé 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.00002 / 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": "baai/bge-large-en-v1.5", "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='baai/bge-large-en-v1.5',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 baai/bge-large-en-v1.5
Alias des chemins de méthode
Utilisez les chemins de méthode indiqués ci-dessus.
ID d’appel associés
FAQ · BAAI: bge-large-en-v1.5
- Quelles entrées et quels résultats sont disponibles ?
POST /v1/embeddings·baai/bge-large-en-v1.5:text,token_ids→embedding- Quels champs la requête utilise-t-elle ?
POST /v1/embeddings·baai/bge-large-en-v1.5:model,input,encoding_format,provider- Quelles limites s’appliquent ?
POST /v1/embeddings·baai/bge-large-en-v1.5:input.budget.maximum:512(octets UTF8);input.min_items:1