AIHub 在 https://ai.yunxinapi.com/hub/v1 下提供 OpenAI-compatible Embeddings 接口，用于向量生成。

Embeddings 请求走标准推理链路，会进行鉴权、接口识别、限流、路由选择、上游调用和计费记录。当前 AIHub 稳定转发的字段为 model、input、dimensions、encoding_format。

具体供应商支持范围以控制台中可用模型、渠道能力和模型授权为准。接入前请确认目标逻辑模型已启用向量能力，且当前访问令牌具备调用权限。

请求 URL

POST https://ai.yunxinapi.com/hub/v1/embeddings

请求头

Header	必填	说明
Authorization	是	AIHub 访问令牌，格式为 Bearer <AIHUB_TOKEN>
Content-Type	是	固定使用 application/json

请求体

字段	类型	必填	说明
model	string	是	AIHub 逻辑模型名，需具备 embeddings 能力且对当前访问令牌可见。
input	string/string[]/array	是	待向量化输入，常见为单个字符串或字符串数组。
dimensions	int	否	指定输出向量维度，仅支持可变维度的 embedding 模型。
encoding_format	string	否	向量编码格式，常见值：float、base64；默认通常为 float。

部分 Backing Gateway 或特定上游可能接受 user、seed、temperature、top_p、frequency_penalty、presence_penalty 等扩展字段，但这些字段不属于当前 AIHub Embeddings 稳定转发子集，请以目标渠道实际能力为准。

请求示例

bashcurl "https://ai.yunxinapi.com/hub/v1/embeddings" \
  -H "Authorization: Bearer $AIHUB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "'"$AIHUB_MODEL"'",
    "input": [
      "Aihub routes embedding requests.",
      "Embeddings are used for retrieval."
    ],
    "encoding_format": "float"
  }'

成功响应

字段	类型	说明
object	string	对象类型，通常为 list。
data	object[]	向量结果列表。
data[].object	string	结果对象类型，通常为 embedding。
data[].embedding	number[]/string	向量内容。encoding_format=base64 时可能为字符串。
data[].index	int	对应输入数组下标。
model	string	实际响应模型名，可能是上游模型名。
usage	object	token 用量，通常包含 prompt_tokens、total_tokens。

上游厂商参数映射

Embeddings 入口当前按 OpenAI-compatible embedding 语义转发，仅声明了 embeddings 能力的渠道参与路由。

目标上游/渠道类型	上游接口	AIHub 入参到上游参数	说明
OpenAI/OpenAI-compatible passthrough/backing gateway	POST https://ai.yunxinapi.com/hub/v1/embeddings	model 映射为渠道配置的上游模型名；input、dimensions、encoding_format 按同名字段发送（字段同 OpenAI 官方）	上游是否支持 dimensions 取决于具体 embedding 模型
Azure OpenAI	Azure OpenAI Embeddings 路径	model 会写成 Azure deployment name；input、dimensions、encoding_format 保持同名语义	Azure 渠道会按渠道配置处理 deployment 和 API version
Aliyun（Qwen）、Moonshot、Zhipu（GLM）、Ark（Doubao-embedding）等	厂商 OpenAI-compatible embeddings 路径	model 映射为厂商模型名；input 等按同名字段发送；dimensions、encoding_format 是否生效取决于厂商官方	测试服可能尚未接入；字段已按官方预先整理，上线后以控制台授权与渠道声明为准
非 Embeddings 能力渠道（Anthropic、Bedrock、DeepSeek 等）	不适用	不路由，不做协议转换	DeepSeek 等请使用其他已开放的 embedding 模型