推理 API Key 用于调用推理 HTTP API,与控制台登录 Session 无关。
控制面 OpenAPI(密钥管理、用量查询等)使用独立的访问令牌(
ot_前缀),见 OpenAPI 概览。本文介绍的是推理调用用的sk-密钥。
获取方式
在 连连智枢 控制台创建租户推理密钥(具体入口以产品为准)。创建后仅展示一次明文,请立即保存到密钥管理系统。
OpenAI 兼容 API
Authorization: Bearer YOUR_API_KEY
所有需认证的 /v1/* 端点(chat、embeddings、files、speech 等)均使用 Bearer。
GET /v1/models 不需要 Key(公开目录)。
Anthropic 兼容 API
任选其一(推荐第一种):
x-api-key: YOUR_API_KEY
或
Authorization: Bearer YOUR_API_KEY
/anthropic/v1/messages 与 /anthropic/v1/models 均需认证。
Key 与租户
- 每个 Key 绑定租户上下文;网关据此校验模型授权、余额、IP 策略等。
- 403 / 401 含义见 错误响应。
不要做的事
| 错误做法 | 正确做法 |
|---|---|
| 在前端页面嵌入生产 Key | 经 BFF / 服务端代理 |
| 把 Key 提交到 Git | 环境变量 + 密钥库 |
| 多系统共用一个 Key | 按服务/环境拆分 |