Los modelos de incrustación convierten datos como texto, imágenes y videos en vectores para tareas posteriores, incluyendo búsqueda semántica, recomendación, agrupamiento, clasificación y detección de anomalías.
Requisitos previos
Obtenga una clave de API y exporte la clave de API como variable de entorno. Si utiliza el SDK de OpenAI o el SDK de DashScope para realizar llamadas, instale el SDK.
Obtener embeddings
- Embedding de texto
- Vectores multimodales independientes
- Vectores multimodales fusionados
- API compatible con OpenAI
- DashScope
Selección de modelo
Elija el modelo adecuado según su tipo de datos de entrada y caso de uso.
-
Procesamiento de texto plano o código: Utilice
qwen3.7-text-embedding. Es el modelo de mayor rendimiento, que admite funciones avanzadas como instrucciones de tarea y vectores dispersos para cubrir la mayoría de los casos de uso de procesamiento de texto. Para escenarios sensibles a los costos que no requieren vectores dispersos u otras funciones avanzadas, utilice la versión ligeraqwen3.7-text-embedding-flash, que mantiene la compatibilidad con 201 idiomas y un contexto de 128K a un precio más rentable. -
Procesamiento de contenido multimodal:
- Incrustación fusionada: Para representar entradas monomodales o de modalidades mixtas como una incrustación fusionada para casos de uso como la recuperación multimodal y la búsqueda de imágenes, utilice
qwen3-vl-embedding. Por ejemplo, puede ingresar una imagen de una camisa con el texto "encuentra un estilo similar que se vea más juvenil", y el modelo fusiona la imagen y la instrucción de tarea en una sola incrustación para su procesamiento. - Incrustación independiente: Para generar una incrustación independiente para cada parte de entrada (como una imagen y su subtítulo de texto correspondiente), utilice
tongyi-embedding-vision-plus,tongyi-embedding-vision-flasho el modelo multimodal de propósito generalmultimodal-embedding-v1.
- Incrustación fusionada: Para representar entradas monomodales o de modalidades mixtas como una incrustación fusionada para casos de uso como la recuperación multimodal y la búsqueda de imágenes, utilice
-
Procesamiento de datos a gran escala: Para procesar datos de texto a gran escala y no en tiempo real, utilice
qwen3.7-text-embeddingotext-embedding-v4con la API por lotes compatible con OpenAI para reducir significativamente los costos.
Embedding de texto
- Beijing
- Hong Kong
- Singapore
| Nombre del modelo | Dimensiones de embedding | Tamaño del lote | Tokens máximos por lote (Nota) | Precio / 1M tokens | Idioma |
|---|---|---|---|---|---|
text-embedding-v4Parte de la serie Qwen3-Embedding | 2,048, 1,536, 1,024 (predeterminado), 768, 512, 256, 128, 64 | 10 | 8,192 | $0.072 | 100+ idiomas principales, incluidos chino, inglés, español, francés, portugués, indonesio, japonés, coreano, alemán, ruso y múltiples lenguajes de programación |
- entrada de matriz de cadenas: La matriz puede contener hasta 10 elementos.
- entrada de archivo: El archivo de texto puede contener hasta 10 líneas.
Embedding multimodal
Este modelo genera embeddings a partir de entradas de texto, imagen o video. Puede utilizar estos embeddings para tareas como clasificación de video e imagen, recuperación de texto-imagen y búsqueda de texto a imagen o de texto a video.
La API acepta entradas individuales de texto, imagen o video, así como combinaciones como texto e imágenes. Algunos modelos admiten múltiples entradas del mismo tipo, como varias imágenes. Para más detalles, consulte las limitaciones de cada modelo.
- Singapore
- China (Beijing)
Modelo | Dimensiones de embedding | Límite de longitud de texto | Límite de tamaño de imagen | Límite de tamaño de video | Precio (por 1M tokens) | Cuota gratuita(Nota) |
|---|---|---|---|---|---|---|
tongyi-embedding-vision-plus | 1152 (predeterminado), 1024, 512, 256, 128, 64 | 1,024 token | Hasta 3 MB por imagen. Admite hasta 8 imágenes. | Hasta 10 MB por archivo de video | Imagen/Video: $0.09 Texto: $0.09 | 1 millón de tokens Esta cuota gratuita es válida durante 90 días a partir de la fecha de activación de Model Studio, lanzamiento del modelo o aprobación de la solicitud, lo que ocurra más tarde. |
tongyi-embedding-vision-flash | 768 (predeterminado), 512, 256, 128, 64 | Imagen/Video: $0.03 Texto: $0.09 |
Restricciones de entrada e idioma
| Modelo multimodal fusionado | ||||
|---|---|---|---|---|
| Modelo | Texto | Imagen | Video | Límite de solicitudes |
| qwen3-vl-embedding | Admite 33 idiomas principales, como chino, inglés, japonés, coreano, francés y alemán.
Todos los idiomas admitidos Chino, japonés, coreano, indonesio, vietnamita, tailandés, inglés, francés, alemán, ruso, portugués, español, italiano, sueco, danés, checo, noruego, neerlandés, finés, turco, polaco, suajili, rumano, serbio, griego, kazajo, uzbeko, cebuano, árabe, urdu, persa, hindi/devanagari y hebreo. | JPEG, PNG, WEBP, BMP, TIFF, ICO, DIB, ICNS y SGI (compatible con URL o Base64) | MP4, AVI y MOV (solo URL) | El número total de elementos de contenido en una sola solicitud no puede exceder 20. El número de imágenes no puede exceder 5. Las imágenes, el texto y los videos comparten este límite. |
| Modelo multimodal independiente | ||||
| Modelo | Texto | Imagen | Video | Límite de solicitudes |
| tongyi-embedding-vision-plus | Chino/Inglés | JPG, PNG y BMP (compatible con URL o Base64) | MP4, MPEG, AVI, MOV, MPG, WEBM, FLV y MKV (solo URL) | No hay límite en el número de elementos de contenido. El número total de tokens de entrada no debe exceder el límite de tokens. |
| tongyi-embedding-vision-flash | ||||
| multimodal-embedding-v1 | El número total de elementos de contenido en una sola solicitud no puede exceder 20. Una solicitud puede contener un máximo de 1 imagen, 1 video y 20 entradas de texto. Estos elementos comparten el límite total. | |||
Características principales
Personalizar dimensiones de vectores
Los modelos qwen3.7-text-embedding, qwen3.7-text-embedding-flash, text-embedding-v4, text-embedding-v3, tongyi-embedding-vision-plus, tongyi-embedding-vision-flash y qwen3-vl-embedding admiten dimensiones de vectores personalizadas. Las dimensiones más altas conservan más información semántica, pero aumentan los costos de almacenamiento y computación.
- Casos de uso generales (Recomendado): Una dimensión de 1024 proporciona un equilibrio óptimo entre rendimiento y costo, lo que lo hace ideal para la mayoría de las tareas de búsqueda semántica.
- Escenarios de alta precisión: Para aplicaciones que requieren alta precisión, puede seleccionar una dimensión de 1536 o 2048. Esto mejora la precisión pero aumenta significativamente la sobrecarga de almacenamiento y cómputo.
- Entornos con recursos limitados: En escenarios sensibles a los costos, seleccione una dimensión de 768 o inferior. Esto reduce significativamente el consumo de recursos a costa de cierta información semántica.
Texto de consulta vs. documento (text_type)
Este parámetro solo está disponible a través del SDK y la API de DashScope.Para lograr resultados óptimos en tareas de búsqueda, debe vectorizar el contenido de manera diferente según su función. El parámetro
text_type está diseñado para este propósito:
text_type: 'query': Utilícelo para el texto de consulta proporcionado por el usuario. El modelo genera un vector "tipo título" que es más direccional y está optimizado para la recuperación de información.text_type: 'document'(predeterminado): Utilícelo para el texto del documento almacenado en su base de conocimientos. El modelo genera un vector "tipo cuerpo" que contiene información más completa y está optimizado para la coincidencia.
query y document. Sin embargo, para tareas como clustering o clasificación donde todos los textos tienen la misma función, no necesita establecer este parámetro.
Instrucciones de tarea (instruct)
Este parámetro solo está disponible a través del SDK y la API de DashScope.Puede proporcionar una instrucción de tarea clara en inglés para guiar a los modelos
qwen3.7-text-embedding y text-embedding-v4 en la optimización de la calidad de los vectores para escenarios de recuperación específicos, mejorando la precisión. qwen3.7-text-embedding mejora la capacidad de seguimiento de instrucciones en un 16.4% respecto a text-embedding-v4, por lo que recomendamos utilizarlo primero. Al usar esta función, debe establecer el parámetro text_type en query.
Vectores densos y dispersos
Este parámetro solo está disponible a través del SDK y la API de DashScope.Los modelos
qwen3.7-text-embedding, text-embedding-v4 y text-embedding-v3 admiten tres tipos de salida de vectores para adaptarse a diferentes estrategias de recuperación. La incrustación dispersa de qwen3.7-text-embedding utiliza una nueva estrategia de entrenamiento similar a SPLADE que mejora la eficacia en un 8.4% y añade compatibilidad para la recuperación entre idiomas.
Tipo de vector (output_type) | Ventajas | Limitaciones | Casos de uso |
|---|---|---|---|
denso | Comprensión semántica profunda que identifica sinónimos y contexto para obtener resultados más relevantes. | Mayores costos de cómputo y almacenamiento. No garantiza una coincidencia exacta de palabras clave. | Búsqueda semántica, preguntas y respuestas impulsadas por IA, recomendación de contenido. |
disperso | Alta eficiencia computacional, centrada en una coincidencia exacta de palabras clave y permitiendo un filtrado rápido. | Carece de comprensión semántica y no puede procesar sinónimos ni contexto. | Recuperación de registros, búsqueda de SKU de productos, filtrado preciso de información. |
denso y disperso | Combina la coincidencia semántica y de palabras clave para obtener resultados de búsqueda óptimos. El costo de generación no cambia, y la sobrecarga de llamadas a la API es idéntica a la del modo de vector único. | Requiere más almacenamiento, y la arquitectura del sistema y la lógica de recuperación son más complejas. | Motor de búsqueda híbrida de alta calidad y nivel de producción. |
Casos de uso
El siguiente código es solo con fines demostrativos. Para producción, precalcule y almacene los embeddings en una base de datos vectorial. De esta manera, solo necesitará generar el embedding de la consulta para la recuperación.
Búsqueda semántica
Realice una coincidencia semántica precisa calculando la similitud entre el embedding de la consulta y los embeddings del documento.
Sistema de recomendación
Analice los embeddings del historial de comportamiento de un usuario para identificar sus intereses y recomendar elementos similares.
Clustering de texto
Agrupe textos similares analizando las distancias entre sus embeddings.
Clasificación de texto
Realice clasificación de texto zero-shot calculando la similitud entre el embedding de un texto de entrada y embeddings de etiquetas predefinidas. Este proceso clasifica el texto en nuevas categorías sin requerir ejemplos preetiquetados.
Detección de anomalías
Identifique datos anómalos calculando la similitud entre el embedding de un texto y el embedding central de muestras normales. Los datos que se desvían significativamente de este patrón se consideran una anomalía.
El valor threshold en el ejemplo es solo con fines demostrativos. El valor ideal varía según el contenido y la distribución de los datos, por lo que debe calibrarlo utilizando su propio conjunto de datos.
Referencia de API
- Embedding de texto general
- Embedding multimodal API de embedding multimodal
Códigos de error
Si la llamada al modelo falla y devuelve un mensaje de error, consulte Códigos de error para su resolución.
Limitación de tasa
Para conocer las condiciones de limitación de tasa del modelo, consulte Limitación de tasa.
Rendimiento del modelo (MTEB/CMTEB)
Evaluaciones comparativas
- MTEB (Massive Text Embedding Benchmark): Un benchmark integral que evalúa el rendimiento de propósito general de los embeddings de texto en tareas como clasificación, clustering y recuperación.
- CMTEB (Chinese Massive Text Embedding Benchmark): Un benchmark a gran escala diseñado específicamente para evaluar embeddings de texto en chino.
- Las puntuaciones oscilan entre 0 y 100. Las puntuaciones más altas indican un mejor rendimiento.
Modelo | MTEB | MTEB (tarea de recuperación) | CMTEB | CMTEB (tarea de recuperación) |
|---|---|---|---|---|
text-embedding-v3 (512 dimensiones) | 62.11 | 54.30 | 66.81 | 71.88 |
text-embedding-v3 (768 dimensiones) | 62.43 | 54.74 | 67.90 | 72.29 |
text-embedding-v3 (1024 dimensiones) | 63.39 | 55.41 | 68.92 | 73.23 |
text-embedding-v4 (512 dimensiones) | 64.73 | 56.34 | 68.79 | 73.33 |
text-embedding-v4 (1024 dimensiones) | 68.36 | 59.30 | 70.14 | 73.98 |
text-embedding-v4 (2048 dimensiones) | 71.58 | 61.97 | 71.99 | 75.01 |