GeiliAPI 接入手册

快速上手

先搞清楚这是什么，再去接入

本教程里说的 GeiliAPI，是一个 API 中转站。你在本站创建一把密钥，填进 Codex、Claude Code 这些编程工具，之后工具发出的请求会走本站线路，并出现在控制台的「使用记录」里。

最后核对

本页更新于 2026 年 9 月 3 日。控制台里的分组名称、价格和可用模型以现网为准，教程只教你怎么选、怎么填、怎么确认成功。

它能帮你做什么

做完本教程，你应该能独立完成这三件事：在控制台拿到一把能用的密钥，把它填进正在用的工具，发出第一句有效回复。

不是 ChatGPT / Claude 网页。这里没有对话框给你聊天，密钥是填进电脑上的编程工具里用的。
不是官方订阅本身。本站提供的是接口中转。官方套餐、账号登录、桌面 App 安装，仍按各工具自己的说明来。
也不用你自己搭服务器。大多数人只需要登录、创建密钥、按教程填配置。

你只需要做三步

  1. 第 1 步

    登录并确认有额度

    打开控制台，看余额或「我的订阅」。没有额度时，后面的工具都会失败，看起来会像密钥写错。

  2. 第 2 步

    按工具创建密钥

    名字可以随便起，比如 codex-macbook。真正要选对的是「分组」：它决定这把钥匙能开哪扇门。

    去创建密钥
  3. 第 3 步

    填进工具，发出第一句

    还没装客户端的，先按教程装上。配置完成后发送「只回复 OK」。再到控制台「使用记录」里看到这把密钥和模型，才算真正走通。

什么是「密钥分组」

创建密钥时，控制台会让你选一个分组。可以把它理解成：这把钥匙能开哪扇门。

Codex、Claude、Gemini 用的不是同一套接口，所以必须选对。密钥名称不会改变协议，分组才决定。

你正在用创建密钥时选地址怎么填
CodexOpenAI 分组https://sub.geiliapi.com/v1
Claude CodeAnthropic 分组https://sub.geiliapi.com（不要加 /v1）
Gemini CLIGemini 分组https://sub.geiliapi.com
Grok CLIGrok 分组https://sub.geiliapi.com/v1
GPT Image 2 生图GPT Image 2 - 1K 或 2K4K网页用在线生图；API 用直连域名
Grok 生图 / 生视频Grok（Heavy）网页用在线生图；API 用直连域名
DeepSeek Harness国模综合https://sub.geiliapi.com/v1
CC Switch按它要接管的那个工具选见对应教程

注意

选错分组，最常见的结果是 401、404，或者工具还在打官方地址。具体选「稳定 / Pro / Kiro / Max」看控制台当时的分组名和 模型价格，教程不展开每个档位。

选你正在用的工具

点进对应教程。每篇都按「安装 → 配置 → 发出第一句 → 核对使用记录」来写，步骤里会配上你实际会看到的界面。还没有密钥的话，先去 创建密钥。

写代码 · 先装客户端安装 Codex桌面端、CLI、VS Code 扩展。一步一张图，装完再接到本站。 写代码 · 填本站密钥Codex 接到本站写入用户级配置。推荐 gpt-5.6-sol，可换成 terra / luna。 写代码 · Claude Code 和 DesktopClaude Code把 Claude 接到本站。日常用 Sonnet，难任务再换 Opus。 写代码 · 官方命令行Gemini CLI把官方 Gemini 命令行指到本站。默认 gemini-3.5-flash。 同时管多个工具CC Switch用图形界面切换 Codex、Claude、Gemini 的供应商。 国模 · 自定义网关DeepSeek Harness必须添加自定义网关。推荐 deepseek-v4-flash。 写代码 · 官方 Grok CLIGrok CLI用 API Key，不要 grok login。推荐 grok-4.6。 出图 · 网页或 APIGPT Image 2 生图1K 与 2K4K 要分开建密钥。不要把 gpt-image-2 填进 Codex。 出图出视频 · 网页或 APIGrok 生图 / 生视频必须用 Grok（Heavy）密钥。Grok CLI 不能出图。

常用地址

控制台用来登录、看用量、管密钥。填进工具里的地址，才是「请求往哪打」。

控制台https://sub.geiliapi.com
Codex / Grok / 国模https://sub.geiliapi.com/v1
Claude / Geminihttps://sub.geiliapi.com

Claude 和 Gemini 的地址不要再加 /v1，工具会自己补路径。抄错时通常会 404。

下一步：先拿到一把密钥，再进对应工具教程。

去创建密钥 先看推荐模型
已复制