BAAI: bge-base-en-v1.5
BAAI bge-base-en-v1.5 convierte texto en inglés en vectores de 768 dimensiones para tareas de búsqueda semántica y similaridad. Su ventana de entrada de 512 tokens y su instrucción de recuperación solo para consultas son adecuadas para pasajes enfocados en un índice de búsqueda documental o de conocimiento.
Sobre el modelo
Esta descripción cubre las capacidades del modelo. Las entradas, salidas y opciones disponibles en Ailoot se indican a continuación para el método seleccionado.
bge-base-en-v1.5 es el modelo de embeddings densos en inglés de tamaño base de BAAI. Convierte cada texto en una representación numérica de 768 dimensiones para recuperación y comparación semántica. El modelo pertenece a la línea BGE v1.5, que aborda la distribución de puntuaciones de similaridad de la familia anterior y mejora la recuperación cuando no se proporciona una instrucción. Su salida es un vector utilizado para comparar textos o encontrar pasajes pertinentes.
Prepara consultas y pasajes
Para una consulta corta que busca pasajes más largos, BAAI recomienda anteponer a la consulta «Represent this sentence for searching relevant passages:». Los pasajes del corpus no reciben esa instrucción. Para otras tareas, se puede generar directamente el embedding del texto original. El fabricante señala que v1.5 también funciona sin instrucción, por lo que la preparación debe elegirse en función de la tarea, en lugar de tratar el prefijo como la única entrada válida.
Una colección práctica de búsqueda puede contener artículos de ayuda, explicaciones de productos o instrucciones técnicas. Una consulta como «How do I change the export format?» debe recuperar el pasaje que describe esa acción. Conserva juntos el encabezado de la sección, las condiciones pertinentes y el texto real de origen. Guarda el identificador y la ubicación del pasaje junto a su vector, para que un resultado de búsqueda pueda devolver algo que el usuario pueda leer o que una etapa posterior de respuesta pueda citar.
Formato del vector y comparación
La representación documentada utiliza el estado oculto final del primer token, o CLS, como embedding de la frase. Los ejemplos del fabricante normalizan el vector y comparan embeddings normalizados con un producto escalar, equivalente a la similaridad del coseno. Las 768 dimensiones son el tamaño de la representación de salida de este modelo; no son una longitud de contexto seleccionable ni un margen de generación de texto.
Utiliza el mismo modelo y la misma convención de preparación para los vectores de consulta y corpus que se comparan. Una comprobación práctica consiste en recuperar pasajes conocidos que contengan la respuesta para un pequeño conjunto de preguntas reales de usuarios y después examinar el texto devuelto. Una forma de vector compatible permite que un índice almacene la representación, mientras que el pasaje de origen establece lo que el resultado realmente dice.
Longitud de entrada y preparación documental
La longitud de secuencia documentada del modelo es de 512 tokens. Por tanto, una fuente larga debe dividirse en pasajes coherentes que contengan respuestas antes de generar sus embeddings. Mantén las definiciones y excepciones junto a la afirmación que matizan y conserva la conexión de un pasaje con su documento principal. El texto del que se genera el embedding incluye cualquier instrucción o encabezado que añadas, por lo que una preparación compacta deja más espacio para el contenido útil de origen.
Para un informe o manual, elige límites en torno a una sección o un pequeño grupo de párrafos relacionados. Un pasaje que solo contiene un título o un fragmento sin su sujeto puede ser difícil de interpretar al recuperarse. Conserva el texto original y una versión de origen, para que una actualización del índice pueda sustituir el material correspondiente cuando cambie el documento.
Puntuaciones y salida útil
BAAI advierte de que los valores absolutos de similaridad no son umbrales universales para decidir que dos textos significan lo mismo. La ordenación relativa importa y un umbral de filtrado debe seleccionarse utilizando la distribución de los datos de la propia tarea. Una similaridad vectorial alta es una señal de recuperación, en lugar de una verificación del contenido factual del pasaje.
El entregable útil es un índice de pasajes en inglés, un conjunto de vectores de consulta o características numéricas para comparación semántica. Un reranker separado puede refinar los candidatos recuperados y una etapa separada de generación puede redactar una respuesta a partir de sus textos. Este modelo base exacto v1.5 en inglés sigue siendo distinto de BGE Large, las ediciones en chino y los perfiles multilingües y de recuperación híbrida de BGE-M3.
Ailoot Ultra · Representaciones vectoriales POST /v1/embeddings baai/bge-base-en-v1.5
baai/bge-base-en-v1.5Inicio
BAAI bge-base-en-v1.5 convierte texto en inglés en vectores de 768 dimensiones para tareas de búsqueda semántica y similaridad. Su ventana de entrada de 512 tokens y su instrucción de recuperación solo para consultas son adecuadas para pasajes enfocados en un índice de búsqueda documental o de conocimiento.
- Entradas aceptadas
- Texto · token_ids
- Resultados
- embedding
Disponible en Ailoot · entradas y métodos
Ailoot Ultra · Representaciones vectoriales POST /v1/embeddings
- Entrada
text,token_ids- Salida
embedding- Formato de salida
- json
| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites baai/bge-base-en-v1.5 | Predeterminado— |
Campoinput | Tipostring|string[]|integer[]|integer[][] | RequisitoObligatorio | Valores y límites Número mínimo de elementos: 1 Condiciones: Lote homogéneo no vacío. Los ID de tokens son números enteros no negativos. Presupuesto de entrada: Máximo: 512 · Unidad de texto: bytes UTF8 · Unidad de tokens: elementos de un arreglo de tokens | Predeterminado— |
Campoencoding_format | Tipostring | RequisitoOpcional | Valores y límites float | Predeterminadofloat |
Campodimensions | Tipointeger | RequisitoNo compatible | Valores y límites Mínimo: 1 | Predeterminado— |
Campouser | Tipojson_value | RequisitoOpcional | Valores y límites Condiciones: La fuente permite este campo metadata de JSON; la semántica exacta en el sistema de origen depende del modelo. | Predeterminado— |
Camposession_id | Tipojson_value | RequisitoOpcional | Valores y límites Condiciones: La fuente permite este campo metadata de JSON; la semántica exacta en el sistema de origen depende del modelo. | Predeterminado— |
Campotrace | Tipojson_value | RequisitoOpcional | Valores y límites Condiciones: La fuente permite este campo metadata de JSON; la semántica exacta en el sistema de origen depende del modelo. | Predeterminado— |
Campoprovider | Tipoobject | RequisitoOpcional | Valores y límites Condiciones: provider.options rechazado | Predeterminado— |
Combinaciones de materiales de entrada
text_to_embedding
Parámetros del método y ciclo de vida
| Parámetro | Contrato |
|---|---|
Parámetrocontent_type | Contratoapplication/json |
Parámetrorequired | Contratomodel, input |
Parámetroinput_shapes | Contratostring, string[], nonnegative_integer_token_array, nonnegative_integer_token_array[] |
Parámetroencoding_format | Contratofloat |
Parámetrodimensions_override | Contratofalse |
Parámetromax_input_budget_units | Contrato512 |
Parámetromultimodal_objects | Contratofalse |
Parámetromaterial_types | Contratotext, token_ids |
Ciclo de vida: synchronous_json
Conserva todos los índices y dimensiones de los vectores.
El nombre de un modelo multimodal no habilita objetos de imagen en esta ruta exacta.
Tarifas
Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado.
- Modo fast
- Sin especificar Cuando se selecciona el modo fast
- Modo flex
- Sin especificar Cuando se selecciona el modo flex
- Esfuerzo máximo de razonamiento
- Sin especificar Cuando el esfuerzo máximo de razonamiento usa el ajuste default
Tarifas de Ailoot
Precios por configuración
| Configuración | Tabla de tarifas | Cargo |
|---|---|---|
| ConfiguraciónTarifas base por token | Tabla de tarifasTarifa base | Cargo Entrada · Tokens de entrada $0.00001 / 1K tokens Salida · Tokens de salida $0 / 1K tokens Entrada · Lectura de caché — / 1K tokens Entrada · Escritura en caché — / 1K tokens Entrada · Escritura en caché, 1 hora — / 1K tokens |
Ailoot reserva un monto estimado antes de la solicitud. Tras obtener el resultado, liquida el cargo definitivo según el uso medido. En las respuestas en flujo, la liquidación usa el registro de uso final. Cómo funcionan la reserva y la liquidación →
Solicitudes de ejemplo
Ailoot Ultra · Representaciones vectoriales
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-base-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-base-en-v1.5',input=["First document","Second document"])
print(result)
for item in result.data:print(item.index,item.embedding)
Recibir y guardar resultados
Ailoot Ultra · Representaciones vectoriales
json
Conserva todos los resultados completados
Conserva todas las respuestas, archivos y partes de contenido completos recibidos.
Conserva cada vector con su índice. La cantidad de vectores debe ser igual a la cantidad de entradas; las dimensiones deben ser consistentes.
Si es necesario revisar la respuesta original
No se incorpora ningún endpoint de tareas de embeddings.
Campos de respuesta
| Campo | Tipo |
|---|---|
Campoobject | Tipostring |
Campomodel | Tipostring |
Campodata[].index | Tipointeger |
Campodata[].embedding | Tipofinite float[] |
Campousage | Tipoobject |
Errores y siguientes pasos
| Respuesta | Condición | Siguiente paso |
|---|---|---|
Respuesta400 · invalid_request_error | CondiciónCampos obligatorios, representación del material o valor del parámetro no válidos | Siguiente pasoCorrige los campos indicados antes de una nueva solicitud de creación. |
Alias
Alias del modelo
Ailoot Ultra baai/bge-base-en-v1.5
Alias de rutas de métodos
Usa las rutas de método indicadas arriba.
ID de modelo relacionados
FAQ · BAAI: bge-base-en-v1.5
- ¿Qué entradas y resultados están disponibles?
POST /v1/embeddings·baai/bge-base-en-v1.5:text,token_ids→embedding- ¿Qué campos utiliza la solicitud?
POST /v1/embeddings·baai/bge-base-en-v1.5:model,input,encoding_format,provider- ¿Qué límites se aplican?
POST /v1/embeddings·baai/bge-base-en-v1.5:input.budget.maximum:512(bytes UTF8);input.min_items:1