获取 API 密钥

API 密钥（部分界面称「令牌」）是调用 ZiAI 的唯一凭证。所有客户端都只需要同一个密钥，差别只在于填进哪个字段。

创建密钥

登录控制台

浏览器打开 https://api.ziai.lol 并登录你的账号。
进入密钥管理页

左侧导航点击「令牌」或「API 密钥」（名称随控制台版本不同）：
- 旧版界面：https://api.ziai.lol/console/token
- 新版界面：https://api.ziai.lol/keys
待补插图控制台密钥管理页
展示左侧导航「令牌 / API 密钥」入口与右上角「创建令牌」按钮；宽 1280，PNG
点击「创建令牌」/「创建 API 密钥」

填写密钥名称。建议按用途命名，例如 claude-code、codex、chatbox-日常、test，便于日后单独禁用某一个而不影响其他工具。
按需配置高级选项（见下表，不确定就全部留空）
保存并立即复制完整密钥

密钥形如 sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx。列表中通常只显示掩码， 创建后请立即复制保存；丢失后一般只能重建。
验证密钥可用

见本页末尾验证密钥。

高级选项含义

配置项	作用	建议
过期时间	到期后密钥自动失效；留空或 `-1` 表示永不过期	生产用途设永不过期；临时测试设 1–7 天
剩余配额	该密钥可消耗的最大额度，超出后自动失效	给不信任的脚本/共享用途设上限
无限配额	开启后不受密钥级配额限制（仍受账户总额度约束）	自己常用可开启
模型限制	限定该密钥只能调用指定模型，留空表示不限制	想省钱时锁定到具体模型
IP 白名单	限定允许使用该密钥的来源 IP，留空表示不限制	固定服务器部署时强烈建议配置
分组	指定该密钥使用的渠道分组，影响可用模型与计费倍率	见计费、配额与限速

密钥安全

本站所有示例中的密钥一律写作 sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx，请替换为你自己的密钥。

验证密钥

方式一：操练场（最简单，推荐第一次使用）

打开 https://api.ziai.lol/console/playground，在左侧选择模型，输入一句话发送。能收到回复即说明账号与密钥可用。

方式二：命令行

用 curl 直接打 ZiAI 的 OpenAI 兼容端点，这条命令也是后续所有排错的基线：

curl https://api.ziai.lol/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -d '{
    "model": "你要测试的模型ID",
    "messages": [{"role": "user", "content": "你好"}]
  }'

Windows PowerShell 用户请改用：

curl.exe https://api.ziai.lol/v1/chat/completions `
  -H "Content-Type: application/json" `
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" `
  -d '{\"model\":\"你要测试的模型ID\",\"messages\":[{\"role\":\"user\",\"content\":\"你好\"}]}'

返回 JSON 且包含 choices 字段即为成功。 若返回错误，先看常见报错速查。

下一步

端点与协议 —— 搞清楚各客户端的地址栏到底该填什么
配置速查表 —— 直接跳到你的工具
CC-Switch 一键配置 —— 同时用 Claude Code 与 Codex 时最省事