Texto

Crear embeddings multimodales

Crea vectores de embeddings con un modelo de embeddings multimodal

POST
/v1/multimodal/embeddings

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

modelstringobligatorio

ID de un modelo que incluya multimodal-embedding, como qwen3-vl-embedding.

inputobject | arrayobligatorio

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) y image_mime_type (string): Datos de imagen en Base64 y su tipo MIME. Aún no está activo.
dimensionsinteger

Número de dimensiones de cada vector devuelto, un entero positivo. El máximo depende del modelo.

Respuesta

objectstring

Siempre list.

dataarray

Una entrada por elemento de entrada.

Cada entrada contiene:

  • object (string): embedding
  • index (integer): Índice del elemento de entrada
  • text_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_embedding o audio_embedding.
modelstring

Modelo utilizado.

usageobject

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

Response
{
  "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

EstadoCódigoCausa
400invalid_requestinput falta, está vacío o un elemento no contiene ninguno de los campos text, image_url, image_base64
400unsupported_endpointEl modelo no incluye multimodal-embedding
400image_input_deferredUn elemento contiene una imagen

Gestione otros estados como se indica en Gestionar errores de la API.

Autorización

BearerAuth
AuthorizationBearer <token>

Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.

Ubicación: header

Encabezados

X-TokenLab-Delivery-Policy?string

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