Texto
Criar Embeddings Multimodais
Cria vetores de embedding com um modelo de embedding multimodal
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
ID de um modelo que lista multimodal-embedding, como qwen3-vl-embedding.
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) eimage_mime_type(string): Dados de imagem em Base64 e seu tipo MIME. Ainda não ativo.
Número de dimensões de cada vetor retornado, um número inteiro positivo. O valor máximo depende do modelo.
Resposta
Sempre list.
Uma entrada por item de entrada.
Cada entrada contém:
object(string):embeddingindex(integer): Índice do item de entradatext_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_embeddingouaudio_embedding.
Modelo utilizado.
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
{
"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
| Status | Code | Causa |
|---|---|---|
400 | invalid_request | input está ausente, vazio ou um item não possui nenhum dos campos text, image_url, image_base64 |
400 | unsupported_endpoint | O modelo não lista multimodal-embedding |
400 | image_input_deferred | Um item contém uma imagem |
Trate outros status conforme descrito em Tratar erros de API.
Autorização
BearerAuth Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.
Local: header
Cabeçalhos
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