Texto
Crear embeddings multimodales
Crea vectores de embeddings con un modelo de embeddings multimodal
Descripción general
Utilice este endpoint con modelos cuyos detalles incluyan la operación multimodal-embedding. Consulte supported_operations en GET /v1/models/{model} antes de enviar una solicitud. Los modelos de embeddings solo de texto utilizan Crear embedding, y este endpoint devuelve 400 unsupported_endpoint para ellos.
Solo la entrada de texto está activa. Una solicitud con image_url o image_base64 devuelve 400 image_input_deferred.
Cuerpo de la solicitud
ID de un modelo que incluya multimodal-embedding, como qwen3-vl-embedding.
Un elemento de entrada, o un array de elementos. Cada elemento necesita al menos uno de los campos a continuación, y la respuesta tiene una entrada por elemento.
text(string): Texto para generar el embedding.image_url(string): URL pública de la imagen. Aún no está activo.image_base64(string) yimage_mime_type(string): Datos de imagen en Base64 y su tipo MIME. Aún no está activo.
Número de dimensiones de cada vector devuelto, un entero positivo. El máximo depende del modelo.
Respuesta
Siempre list.
Una entrada por elemento de entrada.
Cada entrada contiene:
object(string):embeddingindex(integer): Índice del elemento de entradatext_embedding(array): El vector de un elemento de texto. Una entrada incluye un campo de vector denominado según su modalidad:text_embedding,image_embedding,video_embeddingoaudio_embedding.
Modelo utilizado.
Uso de tokens con prompt_tokens y total_tokens, cuando el modelo lo reporta.
Solicitud
curl -X POST "https://api.tokenlab.sh/v1/multimodal/embeddings" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen3-vl-embedding",
"input": [
{"text": "A red bicycle leaning against a brick wall"},
{"text": "A city street at night"}
]
}'El vector de ejemplo se ha abreviado para facilitar la lectura.
Respuesta
{
"object": "list",
"data": [
{ "object": "embedding", "index": 0, "text_embedding": [0.0123, -0.0456, 0.0789] },
{ "object": "embedding", "index": 1, "text_embedding": [0.0211, 0.0334, -0.0102] }
],
"model": "qwen3-vl-embedding",
"usage": { "prompt_tokens": 18, "total_tokens": 18 }
}Errores
| Estado | Código | Causa |
|---|---|---|
400 | invalid_request | input falta, está vacío o un elemento no contiene ninguno de los campos text, image_url, image_base64 |
400 | unsupported_endpoint | El modelo no incluye multimodal-embedding |
400 | image_input_deferred | Un elemento contiene una imagen |
Gestione otros estados como se indica en Gestionar errores de la API.
Autorización
BearerAuth Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.
Ubicación: header
Encabezados
Política de entrega por solicitud. Sustituye los valores predeterminados de la API key y del Workspace. Auto intenta primero con TokenLab Verified y puede cambiar una vez a Official solo antes de la salida, la aceptación de la solicitud o la creación de recursos persistentes.
Valores permitidos
- "auto"
- "verified"
- "official"
Cuerpo de la solicitud
application/json
Respuesta
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json