# 多模态向量化

支持文本、图片、视频混合输入，保留火山原生 data 对象（融合向量）。
国内模型：`volcengine/doubao-embedding-vision-251215`，兼容别名 `volcengine/doubao-embedding-vision`。
海外模型：`volcengine-overseas/skylark-embedding-vision-251215`。
按上游实际用量分别计算文本、视觉输入 token 费用，并应用账号折扣。
携带 API Key 调用 `GET /v1/models` 查询价格；视觉输入单价字段为 `embedding_visual_input_per_1m`，单位为本站币种/百万 token。
无输出 token 费用；上游失败或响应缺少有效向量、用量时释放预冻结金额。
旧模型 `doubao-embedding`、`doubao-embedding-large` 已下架。不同模型的向量空间不同，切换模型时需重建已有向量索引。
同时支持 `/api/v3`、`/v3`、`/api/v1` 前缀。不支持流式输出和预分词整数输入。

## POST /v1/embeddings/multimodal

> 多模态向量化

支持文本、图片、视频混合输入，保留火山原生 data 对象（融合向量）。
国内模型：`volcengine/doubao-embedding-vision-251215`，兼容别名 `volcengine/doubao-embedding-vision`。
海外模型：`volcengine-overseas/skylark-embedding-vision-251215`。
按上游实际用量分别计算文本、视觉输入 token 费用，并应用账号折扣。
携带 API Key 调用 `GET /v1/models` 查询价格；视觉输入单价字段为 `embedding_visual_input_per_1m`，单位为本站币种/百万 token。
无输出 token 费用；上游失败或响应缺少有效向量、用量时释放预冻结金额。
旧模型 `doubao-embedding`、`doubao-embedding-large` 已下架。不同模型的向量空间不同，切换模型时需重建已有向量索引。
同时支持 `/api/v3`、`/v3`、`/api/v1` 前缀。不支持流式输出和预分词整数输入。

### Authentication

`Authorization: Bearer tr-xxx`

### Request Body

Content-Type: `application/json`

- **model** `string` **(required)**  
  
- **input** `object[]` **(required)**  
  
- **input[].type** ``text` | `image_url` | `video_url`` **(required)**  
  
- **input[].text** `string`  
  
- **input[].image_url** `object`  
  
- **input[].video_url** `object`  
  
- **dimensions** ``1024` | `2048``  
  
- **encoding_format** ``float` | `base64` | `null``  
  
- **instructions** `string`  
  
- **sparse_embedding** `object`  
  
- **sparse_embedding.type** ``enabled` | `disabled``  
  
- **multi_embedding** `object`  
  
- **multi_embedding.type** ``enabled` | `disabled``  
  
- **multi_embedding.compression** ``blosc2` | `zstd``  
  

### Response

- **model** `string`  
  
- **object** `string`  
  
- **data** `object` **(required)**  
  
- **usage** `object` **(required)**  
  
- **usage.prompt_tokens** `integer`  
  
- **usage.total_tokens** `integer`  
  
- **usage.prompt_tokens_details** `object`  
  

### Error Codes

- `400`: Invalid model, input or endpoint
- `401`: Missing or invalid API key
- `402`: Insufficient balance
- `403`: Model or channel not allowed
- `502`: Upstream failure, invalid vectors or missing usage
- `503`: Channel configuration or billing unavailable