Intfloat: E5-Base-v2
intfloat E5-Base-v2 transforme du texte anglais en plongements de 768 dimensions avec un encodeur à 12 couches. Les préfixes query/passage et une fenêtre de 512 tokens définissent sa préparation pour la recherche, la comparaison de paraphrases, le regroupement et les caractéristiques textuelles.
À 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.
E5-Base-v2 est le modèle de plongement anglais à douze couches d’intfloat, avec une représentation de 768 dimensions. Il transforme le texte préparé en un vecteur numérique pour la recherche d’information, la comparaison sémantique ou l’utilisation comme caractéristiques dans une autre tâche. La version Base v2 est distincte de l’édition Large v2 à vingt-quatre couches et 1024 dimensions, ainsi que des modèles E5 multilingues entraînés séparément.
Utiliser les préfixes de rôle appris
E5 attend un rôle au début de l’entrée. Pour la recherche de passages, une question commence par « query: » et sa source susceptible de contenir une réponse par « passage: ». Le fabricant recommande « query: » des deux côtés pour les tâches symétriques, comme la similarité sémantique et la recherche de paraphrases. Il recommande aussi ce préfixe lorsque les vecteurs servent de caractéristiques pour le regroupement ou la classification.
Par exemple, une collection de retours clients peut contenir plusieurs demandes formulées différemment pour une même amélioration. Encodez ces enregistrements avec la préparation symétrique recommandée, puis comparez ou regroupez les vecteurs obtenus. Conservez la formulation d’origine et l’identifiant de l’enregistrement avec chaque représentation, afin de pouvoir examiner un groupe comme des messages clients réels plutôt que comme un ensemble inexpliqué de nombres.
Pour une collection destinée à la recherche, préparez les questions et les passages sources avec leurs rôles respectifs. Une requête utile serait « query: Which setting changes the notification frequency? ». Le passage du corpus conserve l’explication et ses conditions pertinentes. Le préfixe fait partie de la préparation apprise par le modèle ; le fabricant précise que l’omettre réduit les performances.
Agréger et comparer la représentation
L’exemple officiel calcule la moyenne des représentations des tokens en tenant compte du masque d’attention et en excluant le remplissage, puis normalise le vecteur obtenu. Un produit scalaire entre plongements normalisés fournit une similarité cosinus. Les 768 valeurs de sortie décrivent un texte ; elles ne constituent ni une réponse, ni un libellé de classe, ni un score de reclassement par paire.
Dans un processus de regroupement, une autre étape forme des groupes à partir de ces vecteurs. Dans un processus de classification, une autre étape les utilise comme caractéristiques d’entrée. Préserver cette distinction facilite l’interprétation du résultat : le plongement représente l’enregistrement, tandis que la tâche en aval détermine un groupe ou un libellé. Utilisez de manière cohérente un même modèle et une même convention de préparation pour les représentations comparées.
Travailler en anglais dans 512 tokens
La fiche du modèle indique que cette édition fonctionne uniquement en anglais et tronque les textes longs à un maximum de 512 tokens. Préparez des passages cohérents dans cette limite, en incluant le préfixe de rôle requis. Une longue critique, un rapport ou un manuel doivent être divisés autour de sections porteuses de sens, plutôt qu’encodés comme une entrée surdimensionnée dont la fin serait perdue.
Gardez un titre avec les phrases qu’il introduit et préservez la condition ou l’exception qui modifie le sens d’une règle. Pour les enregistrements courts, tels que les retours clients, conservez le message complet lorsqu’il tient dans la fenêtre. Un identifiant de source et une version stockés avec le vecteur permettent à une mise à jour ultérieure de la collection de remplacer le bon enregistrement.
Interpréter la similarité selon la tâche
Le fabricant explique que l’ordre relatif des scores cosinus est plus important qu’une valeur absolue. Un seuil de filtrage doit être évalué sur les exemples propres à la collection, et la similarité vectorielle n’est pas une probabilité calibrée d’obtenir un libellé correspondant ou une réponse correcte. Examinez les enregistrements voisins et les correspondances connues comme incorrectes lorsque vous décidez de l’utilisation des vecteurs.
Le livrable utile est un index de recherche anglais, un ensemble de comparaisons sémantiques ou des caractéristiques numériques du texte associées à leurs enregistrements sources. Ce profil Base v2 possède ses propres dimensions, son agrégation et sa préparation des rôles ; la forme du vecteur ou la couverture linguistique d’une autre édition E5 n’établit pas que les représentations sont interchangeables.
Ailoot Ultra · Embeddings POST /v1/embeddings intfloat/e5-base-v2
intfloat/e5-base-v2Pour commencer
intfloat E5-Base-v2 transforme du texte anglais en plongements de 768 dimensions avec un encodeur à 12 couches. Les préfixes query/passage et une fenêtre de 512 tokens définissent sa préparation pour la recherche, la comparaison de paraphrases, le regroupement et les caractéristiques textuelles.
- 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 intfloat/e5-base-v2 | 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 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 | 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 jetons | Barème tarifaireTarif de base | Coût Entrée · Jetons en entrée $0.00001 / 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": "intfloat/e5-base-v2", "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='intfloat/e5-base-v2',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 intfloat/e5-base-v2
Alias des chemins de méthode
Utilisez les chemins de méthode indiqués ci-dessus.
ID d’appel associés
FAQ · Intfloat: E5-Base-v2
- Quelles entrées et quels résultats sont disponibles ?
POST /v1/embeddings·intfloat/e5-base-v2:text,token_ids→embedding- Quels champs la requête utilise-t-elle ?
POST /v1/embeddings·intfloat/e5-base-v2:model,input,encoding_format,provider- Quelles limites s’appliquent ?
POST /v1/embeddings·intfloat/e5-base-v2:input.budget.maximum:512(octets UTF8);input.min_items:1