深色模式
认证与端点
认证
所有网关端点使用 API Key 鉴权：
| 协议 | 请求头 |
|---|---|
| OpenAI 系 | Authorization: Bearer sk-… |
| Anthropic 系 | x-api-key: sk-… + anthropic-version: 2023-06-01（同时兼容 Bearer 头） |
Key 形如 sk-…，在控制台「API 密钥」页创建。Key 必须已分配分组，否则返回 403。
Base URL 与端点总表
| 协议 | Base URL | 端点 |
|---|---|---|
| OpenAI Chat Completions | https://api.nexuskey.cn/v1 | POST /chat/completions |
| OpenAI Responses | https://api.nexuskey.cn/v1 | POST /responses、GET /responses、POST /responses/*（可转发子路径） |
| OpenAI 其他 | https://api.nexuskey.cn/v1 | GET /models、GET /models/{model}、POST /embeddings、POST /images/generations、POST /images/edits、异步生图与 batches 系列 |
| Anthropic Messages | https://api.nexuskey.cn | POST /v1/messages、POST /v1/messages/count_tokens |
| 平台查询 | https://api.nexuskey.cn/v1 | GET /usage、GET /platform/billing |
Anthropic Base URL
Anthropic SDK 的 base_url 填到域名（https://api.nexuskey.cn），SDK 自拼 /v1/messages；多填 /v1 会 404。
Gemini
/v1beta（Google Gemini 协议）暂不开通。
请求与响应约定
- 请求/响应体均为 JSON（流式为 SSE，见 流式（SSE））；
- 协议端点的成功与错误结构跟随端点协议原生格式（OpenAI 式 / Anthropic 式），保证官方 SDK 错误处理兼容；
- 网关侧非协议端点（
/usage、/platform/billing）的错误体为 Anthropic 风格：{"error": {"type": "...", "message": "..."}}； - 控制台 Web API（注册/充值/Key 管理等浏览器接口）错误体为统一
{"code": …, "message": …}，与本站 SDK 调用无关。
通用错误速查
| HTTP | 含义 | 处理 |
|---|---|---|
| 401 | Key 无效/禁用 | 检查 Key |
| 402 | 余额不足 | 充值 |
| 403 | Key 未分配分组/权限不足 | 分配分组 |
| 404 | 模型不存在/子路径不可转发 | 查 /v1/models |
| 429 | 速率限制 | 读 Retry-After 退避 |
| 5xx | 上游/网关错误 | 指数退避重试 |
完整矩阵见 错误码。