API 密钥管理

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

Authorization: Bearer sk-xxxxxxxx

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

创建密钥

点击列表右上角的新建，表单分为三块：基本信息、额度设置、高级设置。填写名称，并确认已选择账户有权使用的路由策略或供应商。

基本信息

额度设置

高级设置

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

供应商路由

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

有两种模式：

智能路由（默认，推荐）

由平台在当前账户已获授权、已加入供应池、支持所请求模型且满足健康要求的供应商中选择线路。异常线路会受到健康检查和熔断规则限制；自动路由不会因此获得账户原本没有的供应商权限。已授权但尚未入池的源，不会自动进入候选范围。

可以选一个偏好策略：

英文界面对应 Fast & Stable（Enterprise） 与 Cost Effective（Value）。名称突出稳定体验与成本取向；内部策略值仍为 success_first 与 price_first。

三步开始使用：

1. 进入左侧 常规 → API 密钥。
2. 编辑已有密钥，或点击新建。
3. 在供应商路由 → 智能路由中选择已授权的策略并保存。已有密钥不用重新创建，客户端中的 Key 字符串也不用替换。

这两个名称表达的是路由偏好，不代表统一价格或固定套餐折扣。源的适用定价、你的会员价格或代理价格仍决定计费，详见账单与对账。

某个策略未获授权时，界面会显示不可用。只有价格池权限的账户可以使用价格优先；两个池都没有权限时，自动路由会拒绝调用，请联系站点管理员检查授权。

还可以设置忽略供应商：把你明确不想用的线路排除掉，剩下的仍由系统自动选。如果排除后没有符合条件的线路，请求会失败。

指定供应商

手动指定一个供应商调用顺序。请求会按你排的顺序，在当前仍有权限且可用的供应商中尝试。此次自动路由升级保留手动选择的具体供应商及顺序。

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

需要锁定某个供应商时，切换到指定供应商，仅保留该已授权供应商，并关闭跨供应商重试。锁定的是供应商分组，该分组内仍可能有多条线路；能否成功取决于其当前模型支持和可用性。

已有密钥如何兼容

无需重新创建 API Key，也无需替换客户端里的密钥字符串。 升级改变的是旧自动策略在请求时采用的路由规则。

编辑旧密钥的名称、额度等信息不会轮换密钥字符串。切换到新自动策略时，只能选择当前已授权的稳定优先或价格优先。

密钥字符串不变，也不等于自动模式下的模型覆盖完全不变。 如果某个模型原来只由池外源提供，升级后的自动请求可能返回 503。仍有该具体供应商分组权限时，可以编辑原 Key，手动指定该供应商；也可以请管理员评估入池或上架配置。此类配置需要单独确认，升级本身不保证已完成。

路由权限被拒绝（403）与池内没有符合条件的模型线路（503）应分开排查，见常见问题排查。

图片相关设置

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

图片响应格式：

图片转存策略（仅在响应格式为「强制 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. 定期查日志 — 在使用日志里按密钥筛选，异常的调用量通常是最早的泄漏信号。

相关