API 密钥管理

API 密钥（API Key）是调用接口的凭证。所有对 /v1/... 接口的请求都要在请求头带上：

Authorization: Bearer sk-xxxxxxxx

菜单位置：左侧 常规 → API 密钥。

创建密钥

点击列表右上角的新建，表单分为三块：基本信息、额度设置、高级设置。只有名称是必填的，其余全部保持默认就能用。

基本信息

额度设置

高级设置

创建成功后立即复制并保存 sk- 开头的密钥。

供应商路由

同一个模型，平台通常接了多条上游线路。界面上把这些线路叫供应商。供应商路由决定你的请求走哪条线，直接影响价格、速度和成功率。

有两种模式：

智能路由（默认，推荐）

由平台自动挑选当前最优的可用供应商，并带熔断机制——某条线路出问题会被自动摘掉，不用你手工干预。

可以选一个偏好策略：

还可以设置忽略供应商：把你明确不想用的线路排除掉，剩下的仍由系统自动选。

指定供应商

手动指定一个供应商调用顺序。请求会严格按你排的顺序尝试。

配合跨供应商重试开关：开启后，当前供应商的线路全部失败时，会按顺序尝试下一个供应商；关闭则只用第一个，失败即返回错误。

图片相关设置

只有调用生图类模型时这两个设置才起作用。

图片响应格式：

图片转存策略（仅在响应格式为「强制 URL」时可选）：

管理已有密钥

密钥列表里每一行可以：

• 查看用量 — 这把密钥的累计消费与调用次数；
• 编辑 — 修改上面所有字段（密钥值本身不会变）；
• 禁用 / 启用 — 临时停用，不影响已有配置；
• 删除 — 永久失效，不可恢复。

批量选中后可以一次性禁用或删除。

密钥状态

在代码中使用

平台兼容 OpenAI 的接口格式，绝大多数 SDK 只需要改两处：base_url 和 api_key。

curl https://<你的站点域名>/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-5.5", "messages": [{"role": "user", "content": "Hello"}]}'

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxxx",
    base_url="https://<你的站点域名>/v1",
)

resp = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: process.env.API_KEY,
  baseURL: 'https://<你的站点域名>/v1',
})

const resp = await client.chat.completions.create({
  model: 'gpt-5.5',
  messages: [{ role: 'user', content: 'Hello' }],
})
console.log(resp.choices[0].message.content)

API 地址就是你当前访问的站点域名，不需要 api. 前缀。完整参数与更多接口见 API 参考。

安全建议

1. 一个用途一把密钥 — 生产、测试、每个同事各自一把。出问题时可以精确定位并单独吊销，不影响其他业务。
2. 用环境变量，不要硬编码 — 密钥不应出现在源码、配置文件、前端代码或截图里。
3. 给密钥设上限 — 对外部协作方、试用场景，关闭「无限配额」并设一个你能接受的金额。
4. 能锁 IP 就锁 IP — 服务端调用的场景，IP 白名单是成本最低的防泄漏手段。
5. 定期查日志 — 在使用日志里按密钥筛选，异常的调用量通常是最早的泄漏信号。

相关