Crea incrustaciones vectoriales para las entradas de texto proporcionadas. Este punto final acepta una sola cadena de texto o una lista de cadenas de texto y devuelve sus incrustaciones vectoriales correspondientes.
Para tareas de búsqueda semántica y recuperación, establece el parámetro input_type a query o document para optimizar cómo el modelo crea los vectores.
Cuerpo
Requerido
entrada
cadena | matriz[cadena] Requerido Una sola cadena de texto o una lista de cadenas de texto para insertar, como
["I like cats", "I also like dogs"].Restricciones:
- Longitud máxima de la lista: 1,000 elementos
- Máximo total de tokens: 1M para
voyage-3.5-liteyvoyage-4-lite; 320K paravoyage-3.5,voyage-4yvoyage-2; 120K paravoyage-3-large,voyage-4-large,voyage-code-3,voyage-finance-2yvoyage-law-2.
-
El modelo de incrustación que se utilizará. Modelos recomendados:
voyage-4-large,voyage-4,voyage-4-lite,voyage-code-3,voyage-finance-2,voyage-law-2.Los valores son
voyage-context-3,voyage-4,voyage-4-lite,voyage-4-large,voyage-3.5,voyage-3.5-lite,voyage-3-large,voyage-code-3,voyage-multimodal-3,voyage-finance-2,voyage-law-2ovoyage-code-2. -
Tipo de texto de entrada. Utilice este parámetro para optimizar las incrustaciones para tareas de búsqueda y recuperación semánticas.
Opciones:
null(predeterminado): el modelo convierte directamente la entrada en vectores numéricos sin ninguna indicación adicional.query: Úselo cuando la entrada represente una consulta de búsqueda. El modelo antepone "Representa la query para la recuperación de documentos de respaldo: " para optimizar la incrustación para la recuperación.document: Se utiliza cuando la entrada representa un documento que se buscará. El modelo antepone "Representar el documento para la recuperación:" para optimizar la incrustación para la recuperación.
Para tareas de búsqueda y recuperación semántica, configure siempre este parámetro en
queryodocument, según corresponda. Las incrustaciones generadas con y sin el argumentoinput_typeson compatibles.Los valores
queryson,documento nulo. -
Si desea truncar los textos de entrada que excedan la longitud del contexto.
true(predeterminado): los textos de entrada que exceden la longitud del contexto se truncan automáticamente antes de la vectorización.false:Se devuelve un error si algún texto de entrada excede la longitud del contexto.
El valor predeterminado es
true. -
El número de dimensiones para las incrustaciones de salida.
La mayoría de los modelos solo admiten una dimensión predeterminada. Los modelos
voyage-4-large,voyage-4,voyage-4-lite,voyage-3-large,voyage-3.5,voyage-3.5-liteyvoyage-code-3admiten los siguientes valores: 256, 512, 1024 (predeterminado) y 2048.Establezca en
nullpara utilizar la dimensión predeterminada del modelo.Los valores son,,,
25651210242048o nulo. -
El tipo de datos para las incrustaciones devueltas.
Opciones:
float(predeterminado): números de punto flotante de precisión simple de 32bits. Ofrece la máxima precisión y exactitud de recuperación. Compatible con todos los modelos.int8Enteros con signo de 8bits, de -128 a 127. Compatible convoyage-4-large,voyage-4,voyage-4-lite,voyage-3-large,voyage-3.5,voyage-3.5-liteyvoyage-code-3.uint8Enteros sin signo de 8bits, de 0 a 255. Compatible convoyage-4-large,voyage-4,voyage-4-lite,voyage-3-large,voyage-3.5,voyage-3.5-liteyvoyage-code-3.binaryValores de incrustación de un solo bit, cuantificados y empaquetados en bits, representados comoint8. La longitud de la lista devuelta es 1/8 deoutput_dimension. Utiliza el método binario de desplazamiento. Compatible convoyage-4-large,voyage-4,voyage-4-lite,voyage-3-large,voyage-3.5,voyage-3.5-liteyvoyage-code-3.ubinaryValores de incrustación de un solo bit, cuantificados y empaquetados en bits, representados comouint8. La longitud de la lista devuelta es 1/8 deoutput_dimension. Compatible convoyage-4-large,voyage-4,voyage-4-lite,voyage-3-large,voyage-3.5,voyage-3.5-liteyvoyage-code-3.
Los valores son
float,int8,uint8,binaryoubinary. El valor predeterminado esfloat. -
El formato en el que se codifican las incrustaciones en la respuesta.
Opciones:
null(Predeterminado): Las incrustaciones se devuelven como matrices. Cuandooutput_dtypeesfloat, cada incrustación es una matriz de números de punto flotante. Para otros valoresoutput_dtype(int8,uint8,binary,ubinary), cada incrustación es una matriz de enteros.base64:Las incrustaciones se devuelven como matrices NumPy codificadas en Base64con los siguientes tipos de datos:numpy.float32cuandooutput_dtypeesfloatnumpy.int8cuandooutput_dtypeesint8obinarynumpy.uint8cuandooutput_dtypeesuint8oubinary
Los valores son
base64o nulos.
curl \
--request POST 'https://ai.mongodb.com/v1/embeddings' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--data '{"input":"string","model":"voyage-context-3","input_type":"query","truncation":true,"output_dimension":256,"output_dtype":"float","encoding_format":"base64"}'{
"input": "string",
"model": "voyage-context-3",
"input_type": "query",
"truncation": true,
"output_dimension": 256,
"output_dtype": "float",
"encoding_format": "base64"
}{
"object": "list",
"data": [
{
"object": "embedding",
"embedding": [
42.0
],
"index": 42
}
],
"model": "string",
"usage": {
"total_tokens": 42
}
}{
"detail": "string"
}{
"detail": "string"
}{
"detail": "string"
}{
"detail": "string"
}{
"detail": "string"
}{
"detail": "string"
}{
"detail": "string"
}{
"detail": "string"
}