Texto

Criar Embeddings Multimodais

Cria vetores de embedding com um modelo de embedding multimodal

POST
/v1/multimodal/embeddings

Visão Geral

Use este endpoint com modelos cujos detalhes listam a operação multimodal-embedding. Consulte supported_operations em GET /v1/models/{model} antes de enviar uma requisição. Modelos de embedding apenas de texto usam Criar Embedding, e este endpoint retorna 400 unsupported_endpoint para eles.

Apenas a entrada de texto está ativa. Uma requisição com image_url ou image_base64 retorna 400 image_input_deferred.

Corpo da Requisição

modelstringobrigatório

ID de um modelo que lista multimodal-embedding, como qwen3-vl-embedding.

inputobject | arrayobrigatório

Um item de entrada ou um array de itens. Cada item precisa de pelo menos um dos campos abaixo, e a resposta tem uma entrada por item.

  • text (string): Texto para gerar embedding.
  • image_url (string): URL pública da imagem. Ainda não ativo.
  • image_base64 (string) e image_mime_type (string): Dados de imagem em Base64 e seu tipo MIME. Ainda não ativo.
dimensionsinteger

Número de dimensões de cada vetor retornado, um número inteiro positivo. O valor máximo depende do modelo.

Resposta

objectstring

Sempre list.

dataarray

Uma entrada por item de entrada.

Cada entrada contém:

  • object (string): embedding
  • index (integer): Índice do item de entrada
  • text_embedding (array): O vetor de um item de texto. Uma entrada contém um campo de vetor nomeado por sua modalidade: text_embedding, image_embedding, video_embedding ou audio_embedding.
modelstring

Modelo utilizado.

usageobject

Uso de tokens com prompt_tokens e total_tokens, quando o modelo o reporta.

Requisição

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"}
    ]
  }'

O vetor de exemplo foi reduzido para facilitar a leitura.

Resposta

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 }
}

Erros

StatusCodeCausa
400invalid_requestinput está ausente, vazio ou um item não possui nenhum dos campos text, image_url, image_base64
400unsupported_endpointO modelo não lista multimodal-embedding
400image_input_deferredUm item contém uma imagem

Trate outros status conforme descrito em Tratar erros de API.

Autorização

BearerAuth
AuthorizationBearer <token>

Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.

Local: header

Cabeçalhos

X-TokenLab-Delivery-Policy?string

Política de entrega por solicitação. Substitui os padrões da API key e do Workspace. Tenta automaticamente o TokenLab Verified primeiro e pode alternar uma vez para Official apenas antes da saída, aceitação da solicitação ou criação de recurso persistente.

Valores permitidos

  • "auto"
  • "verified"
  • "official"

Corpo da requisição

application/json

Resposta

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json