登录并创建密钥

第 1 步：登录控制台

1. 1

   找到登录 / 注册

   打开本站后，先看右上角。没账号点「立即注册」，有账号点「登录」。页面中间那颗「登录控制台」也可以。

   

2. 2

   登录后先看有没有额度

   登录成功会进入控制台。先看首页余额，或左侧「我的订阅」。余额为 0、订阅未开通时，先充值或兑换，不要急着建密钥。

第 2 步：有兑换码就先兑

没有兑换码的人可以跳过这一节。兑换码区分大小写，每个码只能用一次。

1. 1

   左侧点「兑换」

   控制台左侧菜单里找到「兑换」，点进去。主标题是「兑换码」。

   

2. 2

   贴上兑换码，点兑换

   贴进去后点按钮。成功时余额或并发会马上变。失败时看页面提示：码是否用过、是否抄错大小写。

第 3 步：创建一把密钥

进入「API 密钥」。按设备和用途命名，例如 codex-macbook、claude-office。不要在多台电脑上长期共用同一把密钥；丢了一台设备时，禁用对应密钥即可。

1. 1

   打开 API 密钥页

   左侧点「API 密钥」。右上角有一颗青色按钮「+ 创建密钥」。

   

2. 2

   起名字，并选对分组

   弹出「创建密钥」窗口。名称随便起。真正要盯住的是「分组」下拉：它决定这把钥匙能开哪扇门。Codex 选 OpenAI 分组；Claude 选 Anthropic / Claude 相关分组；Gemini、Grok、生图各选各的。具体档位名称以控制台当时为准，对照 模型价格。

   

3. 3

   立刻复制完整 Key

   创建成功后，完整 Key 往往只显示这一次。马上复制到密码管理器。列表里之后只显示前后几位，例如 sk-192...92e4。

   

按工具选择分组

对照下表选择平台分组。具体选「稳定 / Pro / Kiro / Max」看控制台分组名和价格页，教程不展开每个档位。

Base URL 就是工具里要填的「请求往哪打」。Claude 和 Gemini 不要再加 /v1；Codex、Grok、国模要写到 /v1。

第 4 步：用 /v1/models 验证 Key

密钥建好后，先确认这把 Key 本身能用，再去配置客户端。用隐藏输入，不要把 Key 留在终端历史里。看到返回 200、并且 JSON 里有模型列表，就可以往下走。

read -s GEILI_KEY
curl -sS https://sub.geiliapi.com/v1/models \
  -H "Authorization: Bearer $GEILI_KEY"
unset GEILI_KEY

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
$secure = Read-Host "API Key" -AsSecureString
$ptr = [Runtime.InteropServices.Marshal]::SecureStringToBSTR($secure)
$key = [Runtime.InteropServices.Marshal]::PtrToStringBSTR($ptr) -replace '[\x00-\x1F\x7F\s]', ''
[Runtime.InteropServices.Marshal]::ZeroFreeBSTR($ptr)
if ($key.Length -lt 20) { "只读到 $($key.Length) 个字符：这个窗口里 Ctrl+V 不会粘贴，请用鼠标右键粘贴 Key 后重新运行。" } else { Invoke-RestMethod https://sub.geiliapi.com/v1/models -Headers @{Authorization="Bearer $key"} }

可选：一键配置工具

目前只覆盖 Codex、Claude Code 与 Gemini CLI。它会隐藏读取 API Key、先备份旧配置、保留无关设置、写入正确端点，并在完成后提醒重启。CC Switch、DeepSeek Harness 与 Grok CLI 请走各自教程的手动步骤。

curl -fsSL https://sub.geiliapi.com/docs/tools/geili-config.sh -o /tmp/geili-config.sh && bash /tmp/geili-config.sh

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
$dest = Join-Path $env:TEMP "geili-config.ps1"
Remove-Item -LiteralPath $dest -ErrorAction SilentlyContinue
Invoke-WebRequest -UseBasicParsing -Uri "https://sub.geiliapi.com/docs/tools/geili-config.ps1?v=20260904-1" -OutFile $dest
if (-not $?) { throw "Download failed. Open Windows PowerShell, not cmd." }
Unblock-File -LiteralPath $dest
& "$env:SystemRoot\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -ExecutionPolicy Bypass -File $dest