典名词元典名词元首页
API 文档三方工具教程
AI 模型接口多模态向量Multimodal-Embedding

多模态向量(同步)

POST/api/v1/embeddings/multimodal-embedding

Header Parameters

Authorization?string

使用 Bearer Token 认证。 格式: Authorization: Bearer sk-xxxxxx

Request Body

multipart/form-data

model*string

模型名称。支持:

qwen3-vl-embedding

qwen2.5-vl-embedding

tongyi-embedding-vision-plus-2026-03-06

tongyi-embedding-vision-flash-2026-03-06

tongyi-embedding-vision-plus

tongyi-embedding-vision-flash

multimodal-embedding-v1

Value in"qwen3-vl-embedding" | "qwen2.5-vl-embedding" | "tongyi-embedding-vision-plus-2026-03-06" | "tongyi-embedding-vision-flash-2026-03-06" | "tongyi-embedding-vision-plus" | "tongyi-embedding-vision-flash" | "multimodal-embedding-v1"
input*object

输入内容

contents*array<object>

待处理的内容列表。每个元素是一个字典,格式为 {"模态类型": "输入内容"}。

支持 text、image、video、multi_images 四种模态类型。

  • text:value 为字符串
  • image:value 为图片 URL 或 Base64 Data URI
  • video:value 为视频 URL(仅支持公开可访问的 URL)
  • multi_images:value 为图片 URL 数组(仅 tongyi-embedding-vision-plus/flash 及 2026-03-06 快照版本支持)
[]?object
text?string

文本内容

image?string

图片 URL 或 Base64 Data URI(格式:data:image/{format};base64,{data})

video?string

视频 URL(仅支持公开可访问的 URL)

multi_images?array<string>

多图序列列表(仅部分模型支持)

[]?string
parameters?object

向量处理参数

output_type?string

输出向量表示格式,目前仅支持 dense

Value in"dense"
dimension?integer

指定输出向量维度。不同模型支持的值不同:

qwen3-vl-embedding:2560(默认)、2048、1536、1024、768、512、256

qwen2.5-vl-embedding:2048、1024(默认)、768、512

tongyi-embedding-vision-plus-2026-03-06:1152(默认)、1024、512、256、128、64

tongyi-embedding-vision-flash-2026-03-06:768(默认)、512、256、128、64

tongyi-embedding-vision-plus / flash / multimodal-embedding-v1 不支持此参数

fps?number

控制视频帧数采样比例,范围 [0,1],默认 1.0

Default1
instruct?string

自定义任务说明,指导模型理解查询意图。建议使用英文撰写。

enable_fusion?boolean

是否生成融合向量。仅 qwen3-vl-embedding 支持。

true:将 contents 中所有多模态内容融合为 1 个向量。

false(默认):各模态独立生成向量。

Defaultfalse
res_level?integer

指定输入分辨率档位,支持 0/1/2/3 四档(对应单图 token 分别为 127/402/578/1026),默认 1。

仅 tongyi-embedding-vision-plus-2026-03-06 和 tongyi-embedding-vision-flash-2026-03-06 支持。

Default1
Value in0 | 1 | 2 | 3
max_video_frames?integer

控制视频最大采样帧数上限,最大不超过 64,默认 8。

仅 tongyi-embedding-vision-plus-2026-03-06 和 tongyi-embedding-vision-flash-2026-03-06 支持。

Default8
return_original?boolean

返回原厂数据。默认 false:返回中继站标准响应格式(code+data+message+request_id);true:返回原厂格式。

Defaultfalse

Response Body

application/json

成功

TypeScript Definitions

Use the response body type in TypeScript.

code?integer

状态码

data?object

响应数据

output?object
embeddings?array<object>

向量结果列表

[]?object
index?integer

结果在输入列表中的索引

embedding?array<number>

生成的向量数组

[]?number
type?string

输入类型。text/image/video/multi_images 分别对应文本、图片、视频、多图输入。

特殊类型:fusion(qwen3-vl-embedding/qwen2.5-vl-embedding 融合向量)、fused(2026-03-06 快照版本融合向量)、vl(qwen3-vl-embedding 独立向量)。

usage?object
input_tokens?integer

输入 Token 数

image_tokens?integer

图片或视频视觉部分消耗的 Token 数(qwen3-vl-embedding/qwen2.5-vl-embedding/multimodal-embedding-v1 返回)

total_tokens?integer

输入与输出 Token 总数

output_tokens?integer

输出 Token 数(仅 tongyi-embedding-vision-* 系列返回)

input_tokens_details?object

输入 Token 详细分类(仅 tongyi-embedding-vision-* 系列返回)

image_tokens?integer

视觉部分 Token 数

text_tokens?integer

文本部分 Token 数

request_id?string

请求唯一标识

message?string

提示信息

request_id?string

请求ID

curl -X POST "https://api.aa.com.cn/api/v1/embeddings/multimodal-embedding" \  -F model="qwen3-vl-embedding" \  -F input="{\n  \"contents\": [\n    {}\n  ]\n}" \  -F return_original="false"
{
  "code": 0,
  "data": {
    "output": {
      "embeddings": [
        {
          "index": 0,
          "embedding": [
            0
          ],
          "type": "string"
        }
      ]
    },
    "usage": {
      "input_tokens": 0,
      "image_tokens": 0,
      "total_tokens": 0,
      "output_tokens": 0,
      "input_tokens_details": {
        "image_tokens": 0,
        "text_tokens": 0
      }
    },
    "request_id": "string"
  },
  "message": "string",
  "request_id": "string"
}