创建和管理令牌

适用场景

当业务系统需要调用模型接口时，管理员或授权用户需要创建令牌。每个业务系统、环境或应用建议使用独立令牌，便于限额、审计和回收。创建令牌后，系统生成 API Key 明文，业务系统使用该 API Key 发起调用。

前提条件

用户已具备创建令牌的权限。
目标组织已创建。
至少存在一个可用模型和渠道。

创建令牌

登录控制台。
进入 令牌管理 页面。
点击 创建令牌。
输入令牌名称，例如 order-service-prod。
选择归属用户和组织。
配置可调用模型范围。
配置额度和有效期。
如需限制来源，配置客户端 IP 白名单。
点击确定。
在弹出的结果中复制 API Key 明文，并保存到业务系统的密钥管理工具。

字段说明

字段	说明
名称	用于识别调用方，建议包含应用名和环境。
归属组织	用于成本归集和权限控制。
可用模型	限制该令牌能调用的模型。
有效期	到期后令牌不可继续调用。
额度	控制该令牌可消耗的预算或调用量。
IP 白名单	限制允许调用的客户端地址。

验证方式

使用新创建令牌生成的 API Key 调用模型：

curl http://{ROUTER_HOST}:3080/v1/chat/completions \
  -H "Authorization: Bearer {API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {
        "role": "user",
        "content": "health check"
      }
    ]
  }'

调用成功后，在 用量日志 中应能看到对应令牌、用户、组织、模型和渠道记录。

管理令牌

管理员可在 令牌管理 页面执行以下操作：

操作	说明
停用	临时停止令牌调用。
启用	恢复已停用令牌。
调整额度	修改令牌可用额度或预算。
修改模型范围	调整令牌可调用模型。
删除	永久删除令牌。删除后不可恢复。

注意事项

不要多个生产应用共用一个令牌或 API Key。
API Key 泄露后，应立即停用或删除对应令牌并重新创建。
调整模型范围后，建议使用调用示例重新验证。