HAI Gateway

统一接口 Embeddings

用 OpenAI 格式调用 embedding 模型生成向量表示。当前预览阶段仅 OpenAI 系模型直通。

POSTv1/embeddings

预览功能 · 灰度测试中

本端点目前处于灰度测试阶段，仅对部分租户开放。如果调用返回权限错误，说明当前账号尚未加入白名单。生产环境请使用对应的稳定端点（/openai、/anthropic、/google）。预览期间 API 行为可能在后续版本中调整，恕不另行通知。

Authorizations

Authorizationstringheaderrequired

Use the following format for authentication: Bearer sk-pat-您的AccessToken

密钥的值使用 HAI Gateway 的个人访问令牌（以 sk-pat- 开头），与 OpenAI Relay 通道完全一致，无需额外申请 API Key。

Base URL

https://api.hai.network/unified-preview/openai

Body 参数

请求体格式与 OpenAI 官方 Embeddings API 完全一致，详细参数说明请参考 OpenAI 官方文档。

当前仅 OpenAI 系直通

预览阶段 embedding 通道仅支持 OpenAI 与兼容厂商的 embedding 模型（如 text-embedding-3-small、text-embedding-3-large）。如果传入 Google 等其他厂商的 embedding 模型，会返回不支持错误。Google embedContent 等其他厂商的 embedding 转换属于下一期规划。

cURL

Default

cURL:Default

curl https://api.hai.network/unified-preview/openai/v1/embeddings \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-pat-您的Access Token" \
  -d '{
    "model": "text-embedding-3-small",
    "input": "The quick brown fox jumps over the lazy dog"
  }'

200

Default

200:Default

{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [
        0.0023064255,
        -0.009327292,
        "..."
      ]
    }
  ],
  "model": "text-embedding-3-small",
  "usage": {
    "prompt_tokens": 9,
    "total_tokens": 9
  }
}