玄枢API

Embeddings API

OpenAI Embeddings 兼容端点与能力边界。

最后验证日期: 2026-07-23

连接与鉴权

统一 OpenAI 兼容 Base URL: https://www.xuanshuapi.com/v1

OpenAI 兼容接口使用 Authorization: Bearer <YOUR_API_KEY>；Claude Messages 也支持 x-api-key: <YOUR_API_KEY>；Gemini v1beta 使用 x-goog-api-key: <YOUR_API_KEY>。

Embeddings API

POST /v1/embeddings 仅对当前配置中支持向量请求的模型开放。

Embeddings 仅对当前配置中支持的模型开放。

请求体与调用

Embeddings 请求提供模型与单个字符串或字符串数组 input。

curl https://www.xuanshuapi.com/v1/embeddings \
  -H "Authorization: Bearer <YOUR_API_KEY>" -H "content-type: application/json" \
  -d '{"model":"<MODEL_FROM_MODELS>","input":["first document","second document"]}'

响应与流式行为

响应 data 数组按输入顺序返回向量与 index；该端点不支持流式。

HTTP 200
{"object":"list","data":[{"object":"embedding","index":0,"embedding":[0.012,-0.034]},{"object":"embedding","index":1,"embedding":[0.056,0.078]}],"usage":{"prompt_tokens":4,"total_tokens":4}}

关键参数

参数	说明
model	必须是当前配置支持向量请求的模型。
input	字符串或字符串数组。
encoding_format	仅在目标实现支持时设置。

典型故障

400 检查 input 类型；404 检查模型 ID；不支持向量的模型会失败。

HTTP 400  # invalid input type
HTTP 404  # model not found or unavailable
HTTP 429/5xx  # bounded retry candidate

下一步

可用模型、倍率、配额及部分高级能力动态依赖当前 Key 与控制台配置。