API Key 指南

两类不同的 Key

`adminKey`

adminKey 只用于：

/admin/status
/admin/providers
/admin/routing
/admin/api-keys

adminKey 属于宿主机管理员，不应该发给普通客户端。

external API key

external API key 用于：

/v1/models
/v1/audio/transcriptions

这是局域网客户端和内部集成的标准凭据。

推荐签发策略

一把 key 对应一个项目或设备
不建议长期整团队共用一把 key
某个 key 泄露时可以独立吊销，不影响其他调用方
用量可以按集成来源而不是按个人来区分

创建与吊销流程

打开 设置 → External API keys
以项目粒度创建新 key
立即复制完整值
只把它分发给对应的集成方
集成下线或泄露时直接吊销

命名示例

web-dashboard-prod
web-dashboard-staging
python-batch-reports
warehouse-mic-gateway-02

标准请求头

http

Authorization: Bearer vilab_xxxxxxxxxxxxxxxxxxxx

当前暂不包含

这一阶段没有实现：

Key scope
过期时间
单 key 限流
团队级权限控制