获取与管理 API 密钥

在 1折AI 控制台创建 sk- 开头的 API 密钥，以及怎么存放、轮换、在泄露时止损。

一个 API 密钥（API key）对应一份调用权限，扣的是你账户的余额。这页讲怎么建、怎么放、出事了怎么办。

创建 API 密钥

登录控制台
打开 1zheai.com/console。

新建

左侧菜单点「API 密钥」，再点右上角「创建 API 密钥」。名称填一个能看出用途的名字，比如 claude-code-macbook、ci-staging，其它项不改也能用，点「保存更改」。

表单里可以设置的项：

表单项	默认	说明
名称	空	调用日志里按这个名字区分 API 密钥
过期时间	永不过期	可选 1 小时、1 天、1 个月，或指定具体日期和时间
数量	1	一次建多个，名称会自动加随机后缀
「无限配额」开关	打开	关掉后出现「额度 (USD)」，这个 API 密钥最多只能花这么多美元
模型限制（在「高级设置」里）	空，表示所有模型都能用	选了模型后，这个 API 密钥只能调这些模型
IP 白名单（在「高级设置」里）	空，表示不限	只允许列出的 IP 或 CIDR 网段调用

复制保存
API 密钥以 sk- 开头。复制后放进密码管理器或环境变量，不要贴进聊天、截图或代码仓库。

一个工具一个 API 密钥

建议每个工具、每台机器各建一个 API 密钥。好处有三个：

调用日志按 API 密钥区分，哪个工具花了多少钱一眼能看出来。
某个 API 密钥泄露了，只删那一个，其它工具不受影响。
团队里谁的 API 密钥谁负责，离职或换机器时删除对应的 API 密钥。

放在哪里

# 写进 ~/.zshrc 或 ~/.bashrc，只在本机生效
export ONEZHE_API_KEY="sk-你的Key"

[Environment]::SetEnvironmentVariable("ONEZHE_API_KEY", "sk-你的Key", "User")
# 重新打开终端后生效

# .env 要写进 .gitignore
ONEZHE_API_KEY=sk-你的Key

Claude Code 的项目级 .claude/settings.json 通常会提交进仓库，Claude Code 官方文档也明确建议不要把凭据写在这里。API 密钥放用户级的 ~/.claude/settings.json，或者项目里不提交的 .claude/settings.local.json。

泄露了怎么办

在「API 密钥」列表里找到它，点「操作」列的「禁用」图标，或者在「⋯」菜单里选「删除」。禁用后立刻失效，再用它调用会返回 401 Invalid token。
新建一个 API 密钥，换到用到它的地方。
打开调用日志（控制台菜单「使用日志」），点「展开」，在「令牌名称」里填这个 API 密钥的名字筛选，看最近的调用里有没有不是你发起的。

常见问题

API 密钥能同时给 Claude Code 和 Cursor 用吗？

能，API 密钥不绑定工具。只是混用以后日志里分不清是谁花的，所以还是建议分开建。

提示 Invalid token / 401 是 API 密钥的问题吗？

多数是。常见原因：复制时带了空格或换行、API 密钥已删除、填进了工具里错误的字段。逐项排查见错误码与排错。

API 密钥会过期吗？

默认永不过期。创建或编辑时可以在「过期时间」里设一个时间，过期后再调用返回 401 Invalid token，和 API 密钥写错时的回包一样。列表的「过期」列显示每个 API 密钥的过期时间。