协议与接口
Embeddings
用 POST /v1/embeddings 把文本或图片转成向量,用于语义检索和知识库。
首版设计
网关正在开发中,以下为首版接口设计。
import os
from openai import OpenAI
client = OpenAI(base_url="https://api.example.cn/v1", api_key=os.environ["RELAY_API_KEY"])
res = client.embeddings.create(
model="qwen3.7-text-embedding",
input=["如何申请发票?", "充值后多久到账?"],
)
vector = res.data[0].embedding参数
| 参数 | 说明 |
|---|---|
model | 必填,向量模型 ID |
input | 字符串或字符串数组;一次传多条可以减少请求次数 |
dimensions | 输出维度,仅部分模型支持降维(如 doubao-embedding-vision 可降到 1024) |
encoding_format | float(默认)或 base64 |
多模态向量模型(doubao-embedding-vision、qwen3-vl-embedding)还可以输入图片,图片的传入格式以模型详情页为准。
计费
只按输入 tokens 计费,没有输出费用。图片输入按像素折算为 tokens,单价见模型详情页。
可用模型
| 模型 ID | 类型 | 输入 / 1M | 输出 / 1M | 上下文 | 线路 |
|---|---|---|---|---|---|
| doubao-embedding-vision | 向量 | ¥0.70 起 | — 起 | 128K | 火山方舟 |
| qwen3.7-text-embedding | 向量 | ¥0.50 | — | — | 阿里云百炼 |
| qwen3.7-text-embedding-flash | 向量 | ¥0.125 | — | — | 阿里云百炼 |
| qwen3-vl-embedding | 向量 | ¥0.70 起 | — 起 | — | 阿里云百炼 |