创建令牌

令牌（API Key）是调用接口时的凭证，以 sk- 开头。

创建

控制台 → API 密钥 → 创建密钥

字段	建议
名称	按用途命名，例如「生产环境」「测试」「某项目」
额度	留空跟随账户余额；填了就只在这个令牌内限额
过期时间	生产环境建议设一个；测试可留空
分组	决定能调哪些模型，一般保持 default
模型限制	可限定这个令牌只能调某几个模型，默认不限制

管理

列表页能看到每个令牌的：

• 已用额度 / 剩余额度
• 最后使用时间
• 状态（启用 / 禁用）

可以随时：

• 禁用（临时停用，可恢复）
• 删除（永久，不可恢复）
• 重置（生成新密钥，旧的立即失效）

安全建议

1. 一个用途一个令牌——出问题时容易定位，泄露时影响面小
2. 生产环境设过期时间——定期轮换
3. 限定模型——只给这个令牌开它需要的模型
4. 不要写进前端——浏览器里能看到的密钥等于公开的
5. 不要提交到 Git——用环境变量

环境变量用法

export TUMEI_API_KEY="sk-你的令牌"

curl https://www.zzcraft.cn/v1/chat/completions \
  -H "Authorization: Bearer $TUMEI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4.1-flash","messages":[{"role":"user","content":"hi"}]}'

泄露了怎么办

立刻去 控制台 → API 密钥，找到那个令牌点「重置」或「删除」。

重置会立刻让旧密钥失效，新密钥当场可用。已经产生的消费无法追回，但如果及时处理，损失通常可控。

如果你给令牌设了额度上限，泄露的最坏损失就是那个上限——这也是建议设上限的原因。