创建 API Key
API Key 用于在工具发起请求时识别你的 PotatoAPI 账号。注册并登录控制台后,即可为不同工具创建专属密钥。
请妥善保管密钥
API Key 等同于访问凭证。任何拿到密钥的人,都可能消耗你的额度。
创建前准备
请先确认:
- 已注册 PotatoAPI 账号,并能正常登录控制台。
- 账号余额或额度足够调用目标模型。
- 已知道准备在工具中填写的模型名称。
创建步骤
- 登录 PotatoAPI 平台。
- 进入
令牌管理。 - 点击
添加令牌。 - 创建需要使用的令牌。如果你不确定应该选择哪个分组,可以先不手动选择用户分组;如果控制台或监测站提供了分组建议,再根据模型状态、令牌说明和倍率综合选择。
- 保存令牌,并立即复制生成的 Key。
模型限制
模型限制列表默认留空即可。除非你明确理解它的作用,否则不建议新手额外配置。
保存 Key
创建成功后,请立刻把 Key 保存到安全位置。
text
# 示例 Key,请替换为你的实际 Key
sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx不要公开密钥
不要把 API Key 粘贴到公开截图、Issue、聊天记录或代码仓库中。需要排查配置时,请遮挡中间部分。
安全建议
| 建议 | 原因 |
|---|---|
| 不要分享 Key | 他人可能消耗你的额度。 |
| 不要提交到代码仓库 | Git 历史记录很难彻底清理。 |
| 使用环境变量保存 | 工具可以读取配置,又不需要把密钥写死在代码里。 |
| 定期更换 Key | 降低意外泄露后的影响范围。 |
| 禁用不用的令牌 | 避免旧工具继续消耗额度。 |
修改令牌设置
创建 Key 后,可以在控制台中继续修改令牌设置。

可修改的设置
| 设置项 | 用途 |
|---|---|
| 令牌名称 | 给令牌设置易识别的名称,例如 Trae 笔记本 或 Claude Code 服务器。 |
| 配额限制 | 设置无限额度、每日/月度限额或总额度上限。 |
| 速率限制 | 控制每分钟请求数、每小时请求数或并发请求数。 |
| 启用 / 禁用 | 不删除令牌的情况下,临时停止它继续使用。 |
修改步骤
- 登录控制台。
- 找到需要修改的令牌。
- 点击
编辑。 - 修改相关设置。
- 保存更改。
重要提示
- 设置修改后通常会立即生效。
- 某些工具需要重启后才会读取新配置。
- 修改令牌分组可能需要重新创建 Key。
- 后续配置工具时仍会用到 Key,请妥善保存。
环境变量配置示例
请根据具体工具要求选择变量名。下面以 Claude 兼容工具常见的 ANTHROPIC_AUTH_TOKEN 为例。
powershell
$env:ANTHROPIC_AUTH_TOKEN="你的Key"bash
export ANTHROPIC_AUTH_TOKEN="你的Key"