API 客户端管理
API 客户端用于为外部应用或用户提供调用煎蛋平台模型的接口。通过创建 API 客户端,您可以生成 API 密钥,控制可访问的模型范围以及设置用量配额。
概述
API 客户端管理入口位于后台管理的 模型 API 页面。该页面包含两个标签页:
- 聚合模型:管理对外暴露的模型(参见 聚合模型)
- API 客户端:管理调用凭据和配额
创建 API 客户端
在 API 客户端标签页中,点击 创建客户端 按钮。
基本信息
- 客户端名称:客户端的标识名称
- 描述:客户端的用途说明
- 类型:客户端的归属类型,可选 个人、部门 或 项目
模型范围
- 全部聚合模型:客户端可以访问所有已创建的聚合模型
- 自定义:手动选择客户端可以访问的具体模型
API 密钥
创建客户端后,系统会自动生成一个 API 密钥(API Key)。该密钥在调用 API 时作为 Bearer Token 使用,用于鉴权和用量统计。
如果需要重新生成密钥,可以点击 重置密钥 按钮。注意重置后旧密钥将立即失效。
设置配额
为客户端创建配额可以限制其调用量,防止过度使用。
- 时间窗口:配额重置周期,如每 24 小时
- 窗口限额:单个时间窗口内的最大 Token 消耗量
- 允许累积:未使用的额度是否累积到下一个窗口
- 总量限制:客户端的终身最大 Token 消耗量
- 有效期:配额的有效起止日期
管理客户端
在 API 客户端列表中,可以查看所有客户端的名称、类型、模型范围等信息。租户管理员可以删除不再需要的客户端。
使用 API 密钥
获取 API 密钥后,外部应用可以通过标准 OpenAI 兼容接口调用,在请求头中携带密钥:
Authorization: Bearer <API密钥>具体的 API 调用方式请参考 OpenAI 兼容 API。