Skip to main content
令牌(Token / API Key)是调用 Global AI 的凭证,每个令牌可独立配置权限范围和配额上限。左侧导航点击「API密钥」,或直接访问https://globalai.vip/keys 令牌列表展示所有已创建的令牌,包含名称、状态、已用配额、剩余配额、过期时间等信息。

创建令牌

1

打开创建弹窗

API密钥列表页点击右上角「创建API密钥」按钮。
2

填写基本信息

填写令牌名称。建议按用途命名,如「生产环境」「测试用」「Cherry Studio」,方便日后在日志里区分。
3

选择密钥分组

关于分组选择,默认推荐使用「auto」分组。 这个分组的好处是,一个密钥就能调用本站支持的所有模型,系统会根据你实际调用的模型 ID 自动匹配对应的计费分组,省心又灵活。当然,如果你的需求比较明确,比如只打算使用 GPT 系列的模型,也可以直接选择对应的「gpt」分组。这样设置后,该密钥将仅限于调用 GPT 相关模型,无法访问其他厂商的模型,适合对模型来源有严格限制的场景。
4

配置高级选项(可选)

按需配置下方 高级配置选项。所有选项都留空表示不限制,仍受账户总配额约束。
5

提交并保存令牌 Key

确认信息无误后,点击「提交」按钮。创建成功后,新生成的密钥(格式通常为 sk-xxxxxxxx)会出现在密钥列表中。你只需点击密钥右侧的「复制」按钮,即可一键获取密钥,方便在调用时直接使用。
令牌 Key 具有完整的 API 调用权限,请勿泄露给他人,不要提交到公共代码仓库或客户端应用中。建议保存到密码管理器或团队密钥管理系统。

高级配置选项

给不同用途拆分令牌是最佳实践:一个用于生产、一个用于测试、一个交给外部合作方。任意一个泄漏时只需删除该令牌,不会影响其他调用。

使用令牌

将令牌 Key 作为 Authorization: Bearer <令牌>(OpenAI 兼容格式),或对应厂商的原生头部(如 x-api-key),发送到平台的 API Base URL。完整调用示例见 调用 API 如果只想快速验证令牌是否可用,可以在控制台内置的 操练场 里直接对话,无需写代码。

编辑令牌

在令牌列表中找到目标令牌,点击右侧「编辑」图标按钮,可修改令牌的名称、过期时间、剩余配额、模型限制、IP 白名单等配置项。令牌 Key 本身无法修改,只能删除。

删除令牌

在令牌列表中找到目标令牌,点击右侧「删除」图标按钮,确认后该令牌立即失效,无法恢复。使用该令牌的应用会立即返回鉴权错误。
发现令牌泄漏时,请立即删除该令牌并重新创建。可以在删除前查看日志,确认是否有异常调用。

下一步

调用 API

使用令牌发起 OpenAI、Claude、Gemini 格式的调用。

客户端接入

在聊天客户端与 Agent 工具中配置令牌。