推理 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按服务/环境拆分

详见 安全最佳实践密钥生命周期

相关