开始使用
API 地址与 Key
Base URL、身份验证方式，以及 API Key 的创建、限额与撤销。
Base URL
| 协议 | Base URL |
|---|---|
| OpenAI 系：Chat Completions、Responses、Embeddings、Rerank、模型列表 | https://api.example.cn/v1 |
| Anthropic Messages（Claude Code、Anthropic SDK） | https://api.example.cn（不带 /v1） |
两种协议使用同一个 Key。正式域名待定，上线后以控制台显示为准。各协议的区别见 协议总览。
身份验证
OpenAI 系接口在请求头里带上：
Authorization: Bearer sk-relay-xxxxxxxxAnthropic Messages 接口使用 x-api-key（同样接受上面的 Authorization: Bearer）：
x-api-key: sk-relay-xxxxxxxx推理用的 API Key 只能调用模型接口，不能登录控制台、查看账单或修改支付配置。
创建与保存
- Key 只在创建完成时显示一次。平台只保存它的前缀和哈希值，无法再次查看明文；丢失后请撤销并重新创建。
- 不要把 Key 写进前端代码、提交到代码仓库，也不要放进网址参数。推荐放在环境变量
RELAY_API_KEY里。
限定范围与预算
每个 Key 可以单独设置：
| 设置 | 作用 |
|---|---|
| 名称 | 方便区分用途，例如“课题组实验” |
| 可用模型 | 只允许调用列出的模型，其余直接拒绝 |
| 有效期 | 到期后自动失效 |
| 速率与并发 | 每分钟请求数、tokens 与并发上限 |
| 总预算、日 / 月预算 | 达到上限后拒绝新请求；日、月按北京时间切换 |
预算是支出上限，不是余额。钱包余额不足时，即使预算没用完也会被拒绝。
撤销
在控制台撤销后，新的请求会立即被拒绝；已经开始的请求会正常结束并结算。