令牌管理

令牌（Token / API Key）是调用 Tokaify API 的业务凭证。您可以在【令牌管理】页面创建令牌，并按需配置额度、模型、IP 和过期时间等限制。

创建令牌

登录控制台，进入【令牌管理】。
点击【添加令牌】。
填写基础信息：
- 【令牌名称】：建议按用途命名，例如 test、prod-app、nextchat
- 【分组】：按页面可选项选择对应分组
按需配置其他属性后保存。

创建完成后，令牌会出现在列表中。

配置限制

创建令牌时，您可以按需为令牌添加限制条件。

额度限制

可为单个令牌设置额度上限，用于控制该令牌的可用消耗范围。

适合用于：

测试环境限额
合作方独立额度控制
临时项目风险隔离

模型限制

可限制令牌仅访问指定模型，避免误用不需要的模型或高价模型。

适合用于：

固定模型的业务接入
不同模型能力分开管理
按业务用途隔离访问范围

IP 限制

可限制令牌仅允许指定 IP 使用，提升生产环境和固定服务器场景下的安全性。

过期时间

可为令牌设置失效时间，适合演示、临时接入和短期协作场景。

查看密钥与复制接入信息

创建令牌后，您可以在列表中查看并复制接入所需信息。

在【令牌管理】列表中找到目标令牌。
点击【查看完整密钥】查看完整令牌。
按需选择以下方式：
- 【复制令牌】：用于代码、脚本或环境变量接入
- 【复制连接串】：用于第三方客户端或预设接入场景

如果您接入的是自己的程序，通常还需要配合平台的 API 地址 一起使用。

启用、禁用与删除

您可以在令牌列表中对已有令牌进行维护。

启用 / 禁用

可通过开关快速启用或禁用令牌，适合临时停用、风险控制或项目暂停场景。

删除

当令牌不再使用时，可直接删除。

删除前请确认该令牌未被线上服务、脚本或第三方客户端继续使用。

使用建议

建议按项目、环境或用途拆分令牌，避免多个业务共用同一凭证
建议为测试和临时令牌设置额度或过期时间
建议生产环境令牌配合 IP 限制使用
完整令牌默认不会直接暴露在列表中，请在安全环境下查看和复制

常见问题

为什么列表里看不到完整令牌

完整密钥通常需要按需查看，不会默认直接展示在列表中。

已创建令牌但无法使用

建议优先检查以下内容：

账户余额是否充足
令牌是否已禁用
令牌是否已过期
当前模型是否在允许范围内
当前来源 IP 是否被限制

应该复制令牌还是连接串

如果您接入的是自己的程序，通常使用【复制令牌】；如果您接入的是第三方客户端，通常使用【复制连接串】。