文本
创建多模态 Embedding
使用多模态 Embedding 模型生成向量
概述
该端点用于模型详情中列出 multimodal-embedding 操作的模型。发送请求前请读取 GET /v1/models/{model} 的 supported_operations。纯文本 Embedding 模型请使用创建 Embedding 向量,对它们调用本端点会返回 400 unsupported_endpoint。
目前只支持文本输入。带 image_url 或 image_base64 的请求会返回 400 image_input_deferred。
请求体
列出 multimodal-embedding 的模型 ID,例如 qwen3-vl-embedding。
单个输入项,或输入项数组。每项至少包含下列字段之一,响应中每项对应一条结果。
text(string):待转换的文本。image_url(string):公开图片 URL。暂未开放。image_base64(string)与image_mime_type(string):Base64 图片数据及其 MIME 类型。暂未开放。
每个返回向量的维度,正整数。最大值取决于模型。
响应
始终为 list。
每个输入项对应一条结果。
每条结果包含:
object(string):embeddingindex(integer):输入项的索引text_embedding(array):文本项的向量。每条结果只带一个按模态命名的向量字段:text_embedding、image_embedding、video_embedding或audio_embedding。
使用的模型。
Token 用量,包含 prompt_tokens 和 total_tokens(模型报告时才有)。
请求
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"}
]
}'示例向量已截短,便于阅读。
响应
{
"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 }
}错误
| 状态码 | 代码 | 原因 |
|---|---|---|
400 | invalid_request | input 缺失、为空,或某项不含 text、image_url、image_base64 |
400 | unsupported_endpoint | 该模型未列出 multimodal-embedding |
400 | image_input_deferred | 输入项包含图片 |
其他状态码的处理见处理 API 错误。
授权
BearerAuth API Key 身份验证。在 Dashboard > API > API Keys 中创建或管理 API Key。
位置: header
请求头
单次请求的交付策略。覆盖 API 密钥和 Workspace 的默认设置。自动优先尝试 TokenLab Verified,并在输出、请求接受或持久资源创建之前,可能会切换一次至仅限 Official。
可选值
- "auto"
- "verified"
- "official"
请求体
application/json
响应
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json