> ## Documentation Index
> Fetch the complete documentation index at: https://docs.globalai.vip/llms.txt
> Use this file to discover all available pages before exploring further.

# Global AI 令牌管理：创建、限额与安全保管

> 介绍在 Global AI 控制台创建 API 令牌、配置过期时间、剩余配额、模型限制、IP 白名单和分组的完整流程。

令牌（Token / API Key）是调用 Global AI 的凭证，每个令牌可独立配置权限范围和配额上限。左侧导航点击「**API密钥**」，或直接访问[https://globalai.vip/keys](https://globalai.vip/keys)。

令牌列表展示所有已创建的令牌，包含名称、状态、已用配额、剩余配额、过期时间等信息。

## 创建令牌

<Steps>
  <Step title="打开创建弹窗">
    在**API密钥**列表页点击右上角「**创建API密钥**」按钮。
  </Step>

  <Step title="填写基本信息">
    填写令牌名称。建议按用途命名，如「生产环境」「测试用」「Cherry Studio」，方便日后在日志里区分。
  </Step>

  <Step title="选择密钥分组">
    **关于分组选择，默认推荐使用「auto」分组。** 这个分组的好处是，一个密钥就能调用本站支持的所有模型，系统会根据你实际调用的模型 ID 自动匹配对应的计费分组，省心又灵活。

    当然，如果你的需求比较明确，比如只打算使用 GPT 系列的模型，也可以直接选择对应的「gpt」分组。这样设置后，该密钥将**仅限于**调用 GPT 相关模型，无法访问其他厂商的模型，适合对模型来源有严格限制的场景。
  </Step>

  <Step title="配置高级选项（可选）">
    按需配置下方 [高级配置选项](#高级配置选项)。所有选项都留空表示不限制，仍受账户总配额约束。
  </Step>

  <Step title="提交并保存令牌 Key">
    确认信息无误后，点击「提交」按钮。创建成功后，新生成的密钥（格式通常为 `sk-xxxxxxxx`）会出现在密钥列表中。你只需点击密钥右侧的「复制」按钮，即可一键获取密钥，方便在调用时直接使用。
  </Step>
</Steps>

<Warning>
  令牌 Key 具有完整的 API 调用权限，请勿泄露给他人，不要提交到公共代码仓库或客户端应用中。建议保存到密码管理器或团队密钥管理系统。
</Warning>

## 高级配置选项

| 配置项    | 说明                             |
| ------ | ------------------------------ |
| 过期时间   | 设置有效期，留空表示永不过期。                |
| 剩余配额   | 限制该令牌可消耗的最大配额，超出后令牌自动失效。       |
| 无限配额   | 开启后不受令牌配额限制（仍受账户总配额约束）。        |
| 模型限制   | 限定该令牌只能调用指定模型，留空表示不限制。         |
| IP 白名单 | 限定允许使用该令牌的来源 IP，留空表示不限制。       |
| 分组     | 指定该令牌使用的渠道分组，不同分组的可用模型与倍率可能不同。 |

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

## 使用令牌

将令牌 Key 作为 `Authorization: Bearer <令牌>`（OpenAI 兼容格式），或对应厂商的原生头部（如 `x-api-key`），发送到平台的 API Base URL。完整调用示例见 [调用 API](/usage/api)。

如果只想快速验证令牌是否可用，可以在控制台内置的 [操练场](/usage/api#操练场在线测试) 里直接对话，无需写代码。

## 编辑令牌

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

## 删除令牌

在令牌列表中找到目标令牌，点击右侧「删除」图标按钮，确认后该令牌立即失效，无法恢复。使用该令牌的应用会立即返回鉴权错误。

<Note>
  发现令牌泄漏时，请立即删除该令牌并重新创建。可以在删除前查看日志，确认是否有异常调用。
</Note>

## 下一步

<CardGroup cols={2}>
  <Card title="调用 API" icon="code" href="/usage/api">
    使用令牌发起 OpenAI、Claude、Gemini 格式的调用。
  </Card>

  <Card title="客户端接入" icon="plug" href="/clients/overview">
    在聊天客户端与 Agent 工具中配置令牌。
  </Card>
</CardGroup>


## Related topics

- [欢迎](/index.md)
- [Global AI 账号注册与登录方式说明](/account/register-login.md)
- [Global AI 个人设置：账号信息、2FA 与 Passkey](/account/personal-settings.md)
- [调用 Global AI 接口：OpenAI、Claude 与 Gemini 格式](/usage/api.md)
- [Global AI 常见问题：账号、令牌、调用与计费](/faq.md)