接入指南 · 耀耀

先准备三样东西。

账号和余额

注册并登录后，在充值页充值，或到兑换页输入兑换码。余额以美元显示，按 1 元 = $1 记入。

一把绑了分组的 API 密钥

在API 密钥页创建。每把密钥都必须选一个分组：分组决定能用哪些模型、走哪组线路、按什么倍率计费；没有分组的密钥会被拒绝（403）。

一个模型 ID

在模型广场选中你密钥所在的分组，复制完整的模型 ID（区分大小写）。不在这个分组里的模型会报 404。

地址，看工具说的是哪种协议。

同一个站点，不同协议的路径不同。API 密钥页顶部的「API 端点」就是下面的域名，点一下即可复制。

OpenAI 兼容（Chat Completions / Responses）Base URLhttps://yaoyaozzz.com/v1

Anthropic / Claude Code：只填域名https://yaoyaozzz.com

Gemini 原生接口（工具会自己拼 /v1beta 时只填域名）https://yaoyaozzz.com/v1beta

遇到 404，先看完整路径。正确的对话路径是 /v1/chat/completions，不是 /v1/v1/chat/completions。工具自己会补 /v1 的，就只填域名。

「使用密钥」：现成的配置。

在API 密钥列表里，每把密钥的操作里都有「使用密钥」。它按工具（Claude Code、Codex CLI、OpenCode、Gemini CLI 等）和系统（macOS / Linux、Windows CMD、PowerShell）生成可以直接粘贴的配置，地址和密钥都已填好。

里面的默认模型名只是示例。粘贴后把模型换成模型广场里你这把密钥的分组实际有的模型。旁边的「导入到 CCS」可以把配置一键导入 CC Switch。

常用工具怎么填。

Claude Code

地址填域名（不带 /v1），密钥用分组为 Anthropic 线路的那把。

export ANTHROPIC_BASE_URL="https://yaoyaozzz.com"
export ANTHROPIC_AUTH_TOKEN="$YAO_API_KEY"

Codex CLI / OpenCode

走 OpenAI 协议，地址是 https://yaoyaozzz.com/v1。配置文件格式各版本不同，直接用「使用密钥」里对应页签生成的内容最稳。

Gemini CLI

地址填域名，工具自己会拼 /v1beta；模型换成你分组里有的 Gemini 模型。

export GOOGLE_GEMINI_BASE_URL="https://yaoyaozzz.com"
export GEMINI_API_KEY="$YAO_API_KEY"

Cherry Studio 等 OpenAI 兼容客户端

添加「OpenAI 兼容」服务商，地址一般填 https://yaoyaozzz.com/v1（客户端自己补 /v1 的只填域名），再手动添加模型 ID。

先确认密钥能用

列出这把密钥能用的模型，不消耗余额。列表为空，通常是密钥没绑分组或地址填错。

curl https://yaoyaozzz.com/v1/models -H "Authorization: Bearer $YAO_API_KEY"

充值：两种方式。

买额度卡 · 耀耀商城

在充值页的商城选额度卡，支付宝扫码付款
付款后验证，领取兑换码
到兑换页粘贴，即时到账

在线直充

在充值页输入金额（1 元 = $1）
支付宝 / 微信付款
付款成功自动到账，订单在我的订单

兑换码 ≠ API 密钥 ≠ 登录密码。兑换码只在「兑换」页用一次；粘贴时去掉首尾空格，大小写要一致。付了款没到账：商城订单在商城的「我的订单」里点「更新付款与发货状态」；直充订单看控制台的「我的订单」，带上订单号联系客服。

报错，先看状态码。

状态码	意思	先这样查
`401`	密钥不对或已停用	回「API 密钥」重新复制完整密钥；不要把卡密或登录密码当成密钥；确认密钥状态是启用。
`403`	没有权限	常见原因：余额不足、密钥已过期、密钥没绑分组、分组已停用。先看余额，再编辑密钥确认分组。
`404`	地址或模型不对	检查 Base URL 是不是多了或少了 /v1；模型 ID 是否在这把密钥的分组里（模型广场可查）。
`429`	请求太快，或密钥额度限制用完	降低并发、稍后重试；检查密钥上设置的额度限制和速率限制。
`5xx`	上游繁忙或超时	等 10–30 秒再试；持续出现就看「渠道状态」，或换一个分组。

工具里的模型列表是空的？依次检查：地址是否填对（见上方）、密钥是否完整、密钥有没有绑分组。上游持续报 5xx 时，可以看控制台的「渠道状态」。

密钥是钥匙，不是示例文字。

不要把 API 密钥发到群里、截图，或放进公开网页和代码仓库。
一个工具一把密钥，名字写清用途；给别人用或放在服务器上的密钥，设个额度限制和有效期。
怀疑泄露，就在 API 密钥页停用它，再建一把新的。
请求会转发到上游服务。不要提交不愿离开本机的敏感内容。

从旧站搬过来的老用户。

不用改的：域名不变；旧密钥照常可用（带不带 sk- 前缀都行）；旧密码直接登录，邮箱或用户名都可以；以前用 GitHub 或 Discord 登录的，照样点登录页对应的按钮，直接进原账号；余额、兑换码记录、使用记录都已搬过来。
换了名字的：令牌 → API 密钥；钱包 → 充值 / 兑换；额度 → 余额（按 500,000 额度 = $1 换算）。
没有了的：不再支持「sk-xxx-渠道」指定渠道，改用分组；没有签到。
某把旧密钥显示没有分组：编辑它，选一个分组即可。

READY WHEN YOU ARE

准备好了，就去建一把密钥。

选好分组，起个写明用途的名字。

打开 API 密钥 ↗

把耀耀，接进你常用的工具。