Thenlper: GTE-Base
Alibaba DAMO Academy GTE-base genera embeddings de texto en inglés en vectores de 768 dimensiones para recuperación y similaridad semántica. El modelo exacto utiliza pooling por media, admite secuencias de hasta 512 tokens y documenta comparación de tipo coseno con normalización opcional.
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.
GTE-base es el modelo de tamaño base General Text Embeddings entrenado por Alibaba DAMO Academy. Este codificador de texto en inglés se basa principalmente en el marco BERT y produce vectores densos de 768 dimensiones. Su entrenamiento utiliza un corpus grande de pares de relevancia de distintos dominios, con la recuperación de información, la similaridad semántica textual y la reordenación textual basada en embeddings entre las aplicaciones indicadas.
Prepara consultas y pasajes en inglés
Utiliza texto legible en inglés tanto para la necesidad de información como para el material en el que se va a buscar. Por ejemplo, una consulta sobre sustituir un componente desgastado puede compararse con secciones cortas de mantenimiento que describan criterios de sustitución, pasos de inspección e instrucciones de pedido. Conserva el nombre del componente y las condiciones que distinguen esas secciones.
El ejemplo publicado codifica directamente preguntas y texto candidato, sin una instrucción de tarea añadida. Mantén esa preparación coherente entre la colección y las consultas posteriores. Guarda el pasaje original y su identificador junto al vector para que un resultado ordenado pueda mostrar la información que se representó.
Pooling por media y comparación
La receta de referencia promedia las representaciones de tokens del modelo utilizando la máscara de atención, impidiendo que las posiciones de relleno contribuyan al resultado. Después muestra normalización L2 opcional y compara los vectores normalizados mediante su producto escalar. Un ejemplo separado utiliza similaridad del coseno.
Elige y conserva una configuración coherente de normalización y comparación para indexación y recuperación. La salida contiene 768 componentes numéricos; no contiene una respuesta generada. Para una etapa de reordenación de candidatos, codifica los pasajes candidatos con el mismo modelo y ordénalos según su similaridad con la consulta. Esto sigue siendo una comparación basada en embeddings, en lugar de una afirmación de que el modelo lee conjuntamente cada par de consulta y pasaje como un cross-encoder.
Alcance en inglés y entradas de 512 tokens
La ficha exacta limita este modelo al texto en inglés y afirma que las entradas largas se truncan a un máximo de 512 tokens. Por tanto, un manual largo debe convertirse en secciones significativas antes de indexarse. Mantén una advertencia, excepción o matiz junto con la regla que modifica siempre que esos detalles sean necesarios para interpretar el pasaje.
Para una consulta sobre intervalos de mantenimiento, una sección que contenga el intervalo y la condición de funcionamiento es más útil que un fragmento con solo un número. Conserva el encabezado o la identidad del equipo cuando desambigüe la instrucción. Comprueba la longitud según el tokenizador, en lugar de basarte en la cantidad visible de palabras.
Utiliza los pasajes de origen detrás de la puntuación
La recuperación devuelve candidatos de la colección indexada. Examina los primeros pasajes para la tarea exacta y conserva sus ubicaciones de origen al pasarlos a una etapa RAG de redacción de respuestas. Un pasaje relacionado puede tratar de inspección sin autorizar sustitución; esa distinción debe seguir visible en el material de origen.
GTE-base es distinto de GTE-large, que produce vectores de 1024 dimensiones, y de las ediciones GTE multilingües o de contexto ampliado posteriores. Su identidad publicada de modelo define el alcance en inglés, la representación de 768 componentes y el límite de 512 tokens. Utiliza este perfil exacto con consultas y registros de origen representativos al evaluar una colección de recuperación.
Ailoot Ultra · Representaciones vectoriales POST /v1/embeddings thenlper/gte-base
thenlper/gte-baseInicio
Alibaba DAMO Academy GTE-base genera embeddings de texto en inglés en vectores de 768 dimensiones para recuperación y similaridad semántica. El modelo exacto utiliza pooling por media, admite secuencias de hasta 512 tokens y documenta comparación de tipo coseno con normalización opcional.
- 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 thenlper/gte-base | 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": "thenlper/gte-base", "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='thenlper/gte-base',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 thenlper/gte-base
Alias de rutas de métodos
Usa las rutas de método indicadas arriba.
ID de modelo relacionados
FAQ · Thenlper: GTE-Base
- ¿Qué entradas y resultados están disponibles?
POST /v1/embeddings·thenlper/gte-base:text,token_ids→embedding- ¿Qué campos utiliza la solicitud?
POST /v1/embeddings·thenlper/gte-base:model,input,encoding_format,provider- ¿Qué límites se aplican?
POST /v1/embeddings·thenlper/gte-base:input.budget.maximum:512(bytes UTF8);input.min_items:1