文本

创建多模态 Embedding

使用多模态 Embedding 模型生成向量

POST
/v1/multimodal/embeddings

概述

该端点用于模型详情中列出 multimodal-embedding 操作的模型。发送请求前请读取 GET /v1/models/{model} 的 supported_operations。纯文本 Embedding 模型请使用创建 Embedding 向量,对它们调用本端点会返回 400 unsupported_endpoint。

目前只支持文本输入。带 image_url 或 image_base64 的请求会返回 400 image_input_deferred。

请求体

modelstring必填

列出 multimodal-embedding 的模型 ID,例如 qwen3-vl-embedding。

inputobject | array必填

单个输入项,或输入项数组。每项至少包含下列字段之一,响应中每项对应一条结果。

  • text(string):待转换的文本。
  • image_url(string):公开图片 URL。暂未开放。
  • image_base64(string)与 image_mime_type(string):Base64 图片数据及其 MIME 类型。暂未开放。
dimensionsinteger

每个返回向量的维度,正整数。最大值取决于模型。

响应

objectstring

始终为 list。

dataarray

每个输入项对应一条结果。

每条结果包含:

  • object(string):embedding
  • index(integer):输入项的索引
  • text_embedding(array):文本项的向量。每条结果只带一个按模态命名的向量字段:text_embedding、image_embedding、video_embedding 或 audio_embedding。
modelstring

使用的模型。

usageobject

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

示例向量已截短,便于阅读。

响应

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

错误

状态码代码原因
400invalid_requestinput 缺失、为空,或某项不含 text、image_url、image_base64
400unsupported_endpoint该模型未列出 multimodal-embedding
400image_input_deferred输入项包含图片

其他状态码的处理见处理 API 错误。

授权

BearerAuth
AuthorizationBearer <token>

API Key 身份验证。在 Dashboard > API > API Keys 中创建或管理 API Key。

位置: header

请求头

X-TokenLab-Delivery-Policy?string

单次请求的交付策略。覆盖 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