在令牌管理创建 API Key

入口、用途和适用场景

• 入口位置：登录 Routescope 后，在个人中心左侧导航打开【令牌管理】。
• 页面用途：创建 API Key，搜索和筛选令牌，查看额度，复制密钥，并配置可用模型、IP 限制和过期时间。
• 适合什么时候使用：为项目、环境、客户端或团队成员创建独立调用凭证时使用。

令牌的用途

令牌是调用 Routescope API 的业务凭证。调用 API 时，通常需要同时准备：

• 仪表板中的接入地址。
• 令牌管理中创建的 API Key。
• 模型广场中复制的模型 ID。

建议按项目和环境拆分令牌，避免多个业务共用同一个 API Key。

创建令牌

1. 进入【令牌管理】。
2. 点击【添加令牌】。
3. 填写令牌名称，建议使用能识别用途的名称。
4. 按页面字段选择分组、额度、可用模型、IP 限制和过期时间。
5. 保存后，在列表中确认新令牌已创建。

搜索令牌

1. 在令牌列表上方找到搜索框。
2. 输入令牌名称或关键词。
3. 查看列表是否定位到目标令牌。
4. 如需恢复全部列表，清空搜索条件。

按分组和状态筛选

1. 找到分组筛选项。
2. 选择目标分组，查看该分组下的令牌。
3. 找到状态筛选项，筛选启用或禁用的令牌。
4. 筛选项名称和可选状态以页面实际展示为准。

查看令牌额度

1. 在令牌列表中找到目标令牌。
2. 查看额度、已用额度或剩余额度字段。
3. 如果额度不足，编辑令牌额度或创建新的令牌。
4. 如果额度正常但调用失败，继续检查模型限制、IP 限制和过期时间。

查看和复制密钥

1. 在令牌列表中找到目标令牌。
2. 点击查看完整密钥的操作入口。
3. 确认当前环境安全后复制密钥。
4. 将密钥写入服务端环境变量、受保护的配置文件或客户端授权配置。

完整密钥不要公开粘贴到网页、截图或公共仓库中。

配置可用模型

1. 创建或编辑令牌时，找到可用模型配置项。
2. 只选择当前业务需要的模型。
3. 保存后，用该 API Key 测试对应模型是否可调用。
4. 如果调用某个模型失败，先确认模型是否在允许范围内。

配置 IP 限制

1. 创建或编辑令牌时，找到 IP 限制配置项。
2. 填写允许调用的来源 IP。
3. 保存后，从对应服务器发起测试请求。
4. 如果来源 IP 不固定，不建议随意开启严格限制；以业务安全要求为准。

配置过期时间

1. 创建或编辑令牌时，找到过期时间配置项。
2. 为测试、演示或临时协作令牌设置到期时间。
3. 保存后记录过期日期，避免线上服务因令牌过期中断。

启用、禁用和删除令牌

1. 在令牌列表中找到目标令牌。
2. 使用启用或禁用操作控制令牌是否可调用。
3. 令牌不再使用时，再执行删除操作。
4. 删除前确认没有线上服务、脚本或客户端继续使用该 API Key。

常见问题

为什么创建了令牌但调用失败

请检查余额、令牌状态、过期时间、模型限制和 IP 限制。

一个项目应该创建几个 API Key

建议至少按环境拆分，例如测试环境和生产环境使用不同 API Key，便于限制额度和排查调用来源。