从注册到第一次调用。

开始之前

Relay API 提供三类兼容入口。地址只差 /v1，不要混用：

Claude / Anthropic 兼容https://relayapi.appClaude Code 使用，服务端接收 /v1/messages。

OpenAI 兼容https://relayapi.app/v1Codex、SDK 与通用客户端使用。

✦Gemini 原生兼容https://relayapi.appGemini CLI 使用；客户端会自行追加 /v1beta。

1. 注册账号并重新登录。
2. 在「钱包」兑换余额。
3. 在「API Keys」创建并复制密钥。
4. 选择已上线模型，配置客户端后发送短请求。

1. 注册与登录

打开右上角「登录」→「立即注册」。邮箱验证开启时，先填写邮箱并获取验证码，再设置至少 3 位的用户名和至少 8 位的密码；注册成功后邮箱会同时绑定。若页面明确提示验证尚未启用，则本次只创建用户名账号、不会保存邮箱。

2. 充值余额

进入控制台「钱包」，输入已有兑换码并确认。本站按 1 元人民币 = $1 站内额度入账；如还没有兑换码，请联系运营获取。

3. 创建 API Key

进入控制台「API Keys」，点击「创建 Key」。复制并妥善保存 sk- 开头的完整密钥；所有用户创建的 Key 默认可调用全部已上线 Gemini、GPT / Codex 与 Claude 模型，无需升级 VIP。若希望按客户端隔离，也可创建“仅 Gemini”、“仅 GPT / Codex”或“仅 Claude 订阅池”的受限 Key。

4. 选择模型

model 使用下表 API 型号。本站已上架 26 个基础模型，涵盖 Gemini、GPT 和 Claude。推理强度由客户端配置，不作为独立型号。账号轮休或维护不会隐藏已上架型号；实时目录状态单独标注。 正在读取实时状态…

模型	API 型号	上下文	能力 / 场景	目录状态
✦Claude Sonnet 4.6 · Google	gemini-claude-sonnet-4-6	250,000	Google 通道 · 推理 · 编码 · 工具调用	已上架 · 状态待确认
✦Claude Opus 4.6 Thinking · Google	gemini-claude-opus-4-6-thinking	250,000	Google 通道 · 推理 · 编码 · 工具调用	已上架 · 状态待确认
Claude Sonnet 5	claude-sonnet-5	1,000,000	推理 · 编码 · Agent · 工具调用	暂时不可用
Claude Sonnet 5.5	claude-sonnet-5-5	1,000,000	推荐 · 编码 · Agent · 工具调用	暂时不可用
Claude Sonnet 4.6	claude-sonnet-4-6	200,000	推理 · 编码 · 工具调用 · Agent	暂时不可用
Claude Sonnet 4.5	claude-sonnet-4-5	200,000	编码 · 通用 · 工具调用 · 流式输出	暂时不可用
Claude Haiku 4.5	claude-haiku-4-5	200,000	低延迟 · 轻量 · 批量 · 工具调用	暂时不可用
Claude Opus 5.5	claude-opus-5-5	1,000,000	旗舰 · 推理 · Agent · 编码	暂时不可用
Claude Opus 5	claude-opus-5	1,000,000	旗舰 · 编码 · 推理 · 工具调用	暂时不可用
Claude Opus 4.8	claude-opus-4-8	1,000,000	推理 · 编码 · Agent · 工具调用	暂时不可用
Claude Opus 4.7	claude-opus-4-7	1,000,000	编码 · 推理 · Agent · 工具调用	暂时不可用
Claude Opus 4.6	claude-opus-4-6	200,000	推理 · 编码 · 长上下文 · 工具调用	暂时不可用
Claude Opus 4.5	claude-opus-4-5	200,000	旗舰 · 编码 · 写作 · 工具调用	暂时不可用
Claude Fable 5	claude-fable-5	1,000,000	推理 · Agent · 长上下文 · 工具调用	暂时不可用
Claude Fable 5.1	claude-fable-5-1	1,000,000	旗舰 · 推理 · Agent · 工具调用	暂时不可用
✦Gemini 3.8 Flash	gemini-3.8-flash	1,000,000	低延迟 · Agent · 工具调用 · 流式输出	已上架 · 状态待确认
✦Gemini 3.1 Flash Lite	gemini-3.1-flash-lite	1,000,000	轻量 · 批量 · 低成本 · 流式输出	已上架 · 状态待确认
GPT-5.6 Sol	gpt-5.6-sol	1,000,000	推理 · 编码 · Agent · 工具调用	已上架 · 状态待确认
GPT-5.6 Terra	gpt-5.6-terra	1,000,000	通用 · 编码 · 工具调用 · 流式输出	已上架 · 状态待确认
GPT-5.6 Luna	gpt-5.6-luna	1,000,000	轻量 · 批量 · 低成本 · 流式输出	已上架 · 状态待确认
GPT-5.5	gpt-5.5	400,000	通用 · 稳定 · 写作 · 流式输出	已上架 · 状态待确认
GPT-6 Astra	gpt-6-astra	1,000,000	旗舰 · Agent · 推理 · 工具调用	已上架 · 状态待确认
GPT-6.1 Sol	gpt-6.1-sol	1,000,000	推荐 · 编码 · Agent · 工具调用	已上架 · 状态待确认
GPT-6 Sol	gpt-6-sol	1,000,000	推荐 · 编码 · Agent · 工具调用	已上架 · 状态待确认
GPT-6 Luna	gpt-6-luna	1,000,000	高吞吐 · 轻量 · 批量 · 低成本	已上架 · 状态待确认
Codex Auto Review	codex-auto-review	1,000,000	编码 · 代码评审 · 工具调用	已上架 · 状态待确认

实时价格及缓存计费见 模型与定价；当前 Key 的可调用范围以 /v1/models 返回为准。

价格调整：北京时间 2026 年 10 月 15 日起，Google 目录模型（含 Google 通道 Claude）结束国庆七折优惠；GPT 价格维持七折不变。当前 default / vip / svip 分组倍率统一为 1；Google 目录模型按恢复后的基准单价计费，GPT 现有优惠已计入基准价、保持不变。最终单价以模型广场实时价格为准。

所有推理强度使用同一基础模型价格；thinking token 计入输出 token，并按实际生成量结算。

GPT-6.1 Sol：API 型号 gpt-6.1-sol，本站入口总上下文 1M。当前每 1M Token 价格：普通输入与缓存写入均为 $0.70、缓存命中 $0.035、输出 $3.50；输入超过 272K 时，整个请求按普通输入与缓存写入 $1.40、缓存命中 $0.07、输出 $5.25 结算。缓存写入计入首次输入，不额外叠加收费。实时价格以「模型与定价」为准。

GPT-6.1 Sol 的推理强度支持 low、medium（默认）、high、xhigh、max，不支持 none / minimal。Agent 与工具调用使用 /v1/responses；Chat Completions 用于不带工具的对话。

GPT-6 Sol / Luna：当前 Codex OAuth 路由开放 1M 总上下文。短上下文价格分别为 Sol $1 / $0.10 / $5、Luna $0.15 / $0.015 / $0.75（普通输入 / 缓存命中 / 输出，每 1M Token）；输入超过 272K 时，整个请求的普通输入与缓存命中按基础价 2×、输出按 1.5× 计费。Agent 与工具任务优先使用 OpenAI Responses；Chat Completions 只有在 reasoning_effort=none 时支持函数工具调用。

GPT / Codex 模型使用 OAuth 隐式缓存：首次未命中内容计入普通输入，上游明确返回的 cached tokens 按缓存命中价结算，不额外叠加缓存写入费。

也可调用 GET https://relayapi.app/v1/models 获取当前权威列表。已删除的旧型号不会自动重定向，请直接改成上表的新型号。

Claude 模型 API

创建「全部可用模型」或「仅 Claude 订阅池」Key，沿用 default / vip / svip 分组。标准模型同时开放给 default、vip 和 svip；Claude 只开放给 vip 与 svip。Claude 订阅池默认仅支持 Claude Code 协议链路，通过站点根地址连接 Anthropic Messages；通用 SDK、OpenAI 兼容入口与不符合该协议的 CLI 会被拒绝。系统只为一枚指定的集成测试 Key 保留普通 Anthropic Messages 窄例外；例外按鉴权后的 Token ID 匹配，不依赖 User-Agent 伪装，也不复制原始 Key 到代码或日志。客户端特征用于其他 Key 的协议准入与风险判断，不是对本地二进制的密码学证明。

短型号 ID 如 claude-sonnet-4-5 可直接调用，后台映射至对应官方版本。模型及可用范围以当前 Key 的 /v1/models 返回为准。支持文本、流式输出与客户端自定义工具；Claude Code 的合法版本演进字段与能力标头会原样透传，Fast、priority tier、服务端收费工具、container / MCP / geo 等未开放的高风险或额外付费能力仍会明确拒绝。

普通输入、缓存命中、5 分钟或 1 小时缓存创建、输出按上游实际 usage 分桶记录并分别计费，同一批 Token 不重复计费；一次请求可以同时出现缓存命中与新缓存写入。显式请求未开放的 1 小时缓存策略仍会被拒绝，但官方 Claude Code / 上游自动返回的 1 小时缓存 usage 会按实际类别展示和结算。Thinking 计入输出。Fable 5 / 5.1、Sonnet 5 / 5.5、Opus 4.7 / 4.8 / 5 / 5.5 的入口总上下文为 1M；Sonnet 4.6、Opus 4.6 及 4.5 系列仍为 200K，不自动启用额外付费扩展。窗口包含输入与输出，输入预检采用保守估算；价格与其他型号入口范围见「模型与定价」。通过 Relay 使用 1M 窗口时，可在 Claude Code 中选择对应模型的 [1m] 入口；客户端会移除后缀再发送请求。

返回 429 时遵守冷却时间，不要密集重试；503 表示暂无可接流账号或当前会话账号忙碌，请稍后再试。额度与账号管理不会改变已经生成内容的实际计费。

5. 检查本机环境

如果只用现成客户端，可以跳过本节。Claude Code 与 Codex 用户先确认命令行工具能正常启动：

node --version
npm --version
claude --version
codex --version
gemini --version

某条命令不存在时，请先按对应客户端的官方安装说明完成安装；Relay API 不要求安装额外代理 SDK。

6. 接入 Claude Code

Claude Code 使用不带 /v1 的 Anthropic Base URL。选择你的终端，替换 Key 后整段执行：

$env:ANTHROPIC_BASE_URL="https://relayapi.app"
$env:ANTHROPIC_AUTH_TOKEN="sk-your-relay-key"
claude --model claude-sonnet-5

如果 Claude Code 提示本地 model catalog 尚未描述这个新型号，先更新 Claude Code；也可在客户端的 model picker 中把该型号 behavesAs 映射为同家族已知模型。这是客户端上下文窗口提示，不代表 Relay 请求失败。

7. 用 CC Switch 配置 Claude Code

如果你用 CC Switch 管理 Claude Code 的供应商，按下面 9 步配置。请求地址填写 https://relayapi.app，不要追加 /v1；API Key 使用控制台新建的 sk- 密钥。

1. 创建并复制 API Key

   进入 Relay 控制台「API Keys」，新建密钥并立即保存。不要把 Key 发给他人或粘贴到公开截图。

   

2. 打开添加供应商

   在 CC Switch 的 Claude 页面点击右上角「+」。

   

3. 选择「自定义」

   Relay 使用 Anthropic Messages 兼容入口，不要选择其他站点的固定模板。

   

4. 填写 Relay 信息

   供应商名称可写 RelayAPI；API Key 填刚创建的密钥；请求地址填 https://relayapi.app。上游格式选择「Anthropic Messages（原生）」；认证字段使用默认的 ANTHROPIC_AUTH_TOKEN。

   

5. 获取并映射模型

   点击「获取模型列表」，从返回的基础模型中选择一个。Claude 模型推荐先用 claude-sonnet-5；推理强度在 Agent 内调整。

   

6. 保存并启用供应商

   保存配置后回到供应商列表，确认 RelayAPI 已被选中。

   

7. 在 Claude Code 打开模型菜单

   启动 Claude Code，输入 /model。

   

8. 选择 Relay 模型

   选择刚才映射的模型。如果客户端提示 unknown model catalog，请按上一节说明更新 Claude Code 或配置 behavesAs。

   

9. 发送短消息验证

   先发送一个简短问题；正常回复即代表 CC Switch、Claude Code 与 Relay API 已连通。

   

若「获取模型列表」失败，先确认 CC Switch 进程没有继承失效的 HTTP_PROXY / HTTPS_PROXY / ALL_PROXY，再检查 Key 和请求地址；不要反复新建 Key。

Windows：CC Switch + Claude Code 桌面端

上面展示了 Claude Code CLI 的配置与调用；Windows 用户也可以使用 Claude 桌面应用中的 Code 页面。以下为 Windows 版 CC Switch 与桌面端 Gateway 设置的实际界面，不是网页聊天入口。

1. CLI 配置：在 CC Switch 的「Claude Code」页添加并启用 RelayAPI，使用 https://relayapi.app 和本站 API Key；配置方法与上面的教程一致。
2. 桌面端配置：还需检查 CC Switch 的「Claude Desktop」页，按当前版本提供的 Gateway 配置流程接入。仅在「Claude Code」页启用供应商，不代表桌面端已经完成配置。
3. 连接本机 Gateway：使用 CC Switch 提供的本机地址、凭证和认证方式完成桌面端设置。127.0.0.1 指向用户自己的电脑；本机 Gateway 凭证与 RelayAPI Key 用途不同，不要混填，也不要照抄截图中被遮挡的地址。
4. 保存并验证：保持 CC Switch 本机网关运行，在桌面端应用设置后点击 Check again；再进入 Code 页面，选取本站可用模型并发送一条短消息。模型映射以「Claude Desktop」页的实际配置为准。

桌面端凭证检测与 CLI 调用是两条不同的请求流程。

本站已适配桌面端最小凭证检测。检测通过后仍需确认 Code 页面能够实际回复；出现 403 时先查看 Details 中的具体原因，不一定是 Key 错误；出现 429 时按提示等待冷却，不要连续点击重试。此适配不代表开放所有桌面功能或其他服务端工具。

界面随客户端版本更新可能变化。参考 Claude Code 桌面端文档 与 CC Switch 项目说明；分享截图前请隐藏完整密钥。

8. 接入 Codex

Codex 使用 OpenAI 兼容地址，必须带 /v1。以下示例使用已上架的 GPT-6.1 Sol（gpt-6.1-sol），工具任务使用 Responses 协议。先查看上方目录状态，再替换 Key 执行：

$env:OPENAI_BASE_URL="https://relayapi.app/v1"
$env:OPENAI_API_KEY="sk-your-relay-key"
codex --model gpt-6.1-sol

用 CC Switch 配置 Codex

切换到 CC Switch 顶部的 Codex 页面，新增自定义供应商。请求地址填写 https://relayapi.app/v1，协议选择 OpenAI 兼容；高级设置推荐使用 Responses 原生协议，再从模型列表选择需要的 GPT 型号。

如果切换器支持「完整 URL」，保持关闭即可；不要让它在已有 /v1 后重复追加版本前缀。

Google 目录中的 Claude 4.6

以下型号由 Google Antigravity 提供，不是暂时停用的 Claude 直连订阅池。请选择“全部可用模型”或“仅 Google / Gemini”Key；使用 Gemini 订阅额度，并按现有钱包溢出设置处理余额。Claude 专用 Key 不包含这两个型号。

• gemini-claude-sonnet-4-6 — Claude Sonnet 4.6
• gemini-claude-opus-4-6-thinking — Claude Opus 4.6 Thinking

这两个型号按 Google 目录独立计费，输入、缓存命中与输出的实时价格以模型广场为准；Thinking tokens 计入输出。Google 传输未独立报告缓存写入量时，不虚构写入账单，新内容只按普通输入计费。

支持 Chat Completions、Responses、Anthropic Messages 与 Gemini generateContent；Google 上游目录标称上下文为 250K（maxTokens=250000），最大输出预算为 64K（maxOutputTokens=64000，含思考）；已核对当前账号的实时目录，尚未做 250K 边界生成测试。这是 Antigravity 通道规格，不套用 Anthropic 直连的 1M 规格。支持客户端函数工具与混合联网搜索，不要求必须使用 Claude Code。使用 Claude Code 时，请将主模型和辅助模型都配置为上述可用 ID。

混合搜索由 Claude 决定查询并生成最终答案，Gemini 3.8 Flash 只执行搜索，返回真实搜索来源。支持 googleSearch、web_search / web_search_preview 与 Messages 的 web_search_20250305。每个请求最多执行 7 次辅助搜索（最多 7 轮；并行搜索也计入总次数，一次搜索可返回多个网页来源），客户端指定更小的 max_uses 时按较小值执行；URL Context、代码执行和未适配的筛选／定位选项仍会明确拒绝。

Claude 主模型与辅助 Gemini 的 Token 按各自模型现价分项计费（含已报告的缓存命中与思考 Token），合并扣除 Gemini 订阅或钱包额度，不另加固定搜索费。调用记录可查看搜索用量和费用明细。混合搜索需先完成工具往返，再发送流式事件，因此等待首个事件可能比普通文本请求更久；搜索失败不会冒充已联网回答。

Google 文档目前列出该系列于 2026-11-02 移除；实际可用性以 Google 上游和站内实时目录为准。

✦9. 接入 Gemini CLI

Gemini CLI 走 Gemini 原生 /v1beta 协议。Base URL 必须填写站点根地址 https://relayapi.app，不要追加 /v1；客户端会自行拼接 /v1beta/models/…。

$env:GOOGLE_GEMINI_BASE_URL="https://relayapi.app"
$env:GEMINI_API_KEY="sk-your-relay-key"
$env:GEMINI_MODEL="gemini-3.8-flash"
gemini

用 CC Switch 配置 Gemini CLI

切换到 CC Switch 顶部的 Gemini 页面，新增 RelayAPI：请求地址填 https://relayapi.app，API Key 填控制台密钥，然后获取模型列表、保存并启用。这里使用的是 Gemini 原生协议，不是 Anthropic 协议。

若报错路径形如 /v1/v1beta/models/…，说明 Base URL 多写了 /v1；删掉后保存并重新启动 Gemini CLI。

协议与联网搜索工具

一个 API Key 可以接入主流编程 CLI。Relay 采用原生协议优先、跨模型核心兼容：Gemini CLI 使用 Gemini generateContent，Codex 使用 OpenAI Responses，Claude Code 使用 Anthropic Messages；Claude 订阅池默认只开放 Claude Code 协议链路，另有一枚指定集成测试 Key 可走普通 Anthropic Messages；原生模型组合提供最佳体验，跨模型组合提供对话与核心 Agent 工具兼容。

跨厂商转换会尽量保留消息、工具调用和多轮状态，但服务端搜索、引用、思考签名、推理档位和工具续接等厂商专属能力不保证无损互换。兼容范围以模型广场及对应客户端章节的标记为准。

10. 调用 OpenAI 兼容 API

先用短请求验证 Key、余额、地址和模型名，再开始长任务。鉴权统一使用 Authorization: Bearer YOUR_KEY。

curl https://relayapi.app/v1/chat/completions \
  -H "Authorization: Bearer sk-your-relay-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"gemini-3.8-flash","messages":[{"role":"user","content":"Reply with: RELAY_OK"}],"stream":true}'

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-relay-key",
    base_url="https://relayapi.app/v1",
)
response = client.chat.completions.create(
    model="gemini-3.8-flash",
    messages=[{"role": "user", "content": "Reply with: RELAY_OK"}],
)
print(response.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-your-relay-key",
  baseURL: "https://relayapi.app/v1",
});
const response = await client.chat.completions.create({
  model: "gemini-3.8-flash",
  messages: [{ role: "user", content: "Reply with: RELAY_OK" }],
});
console.log(response.choices[0].message.content);

✦11. 提升缓存命中率

Relay 会尽量把同一段对话送回同一个上游账号，减少长上下文重复计算。要建立这种会话亲和，客户端需要为每段对话提供一个稳定且唯一的标识；它只用于路由，不替代真实消息内容。

自己编写 SDK 或 API 客户端

推荐在顶层 JSON 中加入 prompt_cache_key。每段新对话生成一次 UUID，同一对话后续请求复用；不同对话必须使用不同值。

{
  "model": "gemini-3.8-flash",
  "prompt_cache_key": "550e8400-e29b-41d4-a716-446655440000",
  "messages": [
    {"role": "user", "content": "你好"}
  ]
}

命中条件与计费

会话亲和只会提高命中概率，不能保证 Google 隐式缓存一定命中。尽量把大段公共内容放在 Prompt 前部、保持公共前缀稳定，并在合理时间内继续同一对话。只有上游明确返回 cached tokens 时，这部分才按缓存价格计费；未命中或上游未报告的输入按普通输入价格结算。

计费说明

• 输入与输出 token 分别按「模型与定价」页的每 1M tokens 单价计费。
• 请求采用预扣 + 结算：先按预估用量扣减，完成后按真实用量多退少补。
• 余额、token 用量和扣费记录可在控制台查看；流式与非流式请求采用相同单价。
• 价格以站内额度计，充值口径为 1 元人民币 = $1 站内额度。

加入交流群

欢迎加入 RelayAPI 快乐小站，交流接入配置、模型使用与问题反馈。QQ 群号：965203104。

常见问题