POST https://ai.win10030.com/v1/embeddings
POST /embeddings(Embeddings)。为文本生成 embedding 向量,格式与 OpenAI Embeddings API 一致。
认证
Authorization: Bearer YOUR_API_KEY
请求体
| 字段 | 必填 | 说明 |
|---|---|---|
model | 是 | 目录中支持 embedding 的模型 id |
input | 是 | 字符串或字符串数组 |
encoding_format | 否 | float(默认)或 base64 |
dimensions | 否 | 降维(上游支持时) |
user | 否 | 终端用户标识(可选) |
extra_body | 否 | 网关扩展:JSON 对象,并入上游 extra_body(OpenAI 兼容线路) |
限制: JSON 请求体最大约 32 MB。
未列出的顶层字段在允许时可能传给上游。
示例
curl -sS "https://ai.win10030.com/v1/embeddings" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_EMBEDDING_MODEL_ID",
"input": ["hello world", "routerbrain"]
}'
响应
响应为 OpenAI 格式,含 data[](每项 embedding、index)、model、usage。
错误
| 状态码 | 常见原因 |
|---|---|
| 400 | 模型不支持 embedding、body 无效 |
| 401 | Key 无效 |
| 403 | 模型未授权或余额不足 |
| 429 | 限流 |
见 错误响应。
SDK
@routerbrain/sdk 的 embeddings.* 未实现,请直接调用 HTTP 本端点。