三分钟上手
从注册到第一次成功调用,跟着图走,六步搞定。不需要先懂 API、Token 或命令行。
Cherry Studio · 自己的代码
按分组折扣计费
注册并登录
界面示意,以实际页面为准
- 1填写用户名和密码(8–128 位),再输一遍确认。
- 2填写邮箱,点「发送验证码」,把邮件里的 6 位验证码填回来。
- 3等人机校验显示「成功」,勾选协议,点「创建账户」。
没收到验证码?先看垃圾邮件箱;仍没有就等 60 秒后重发,或换一个邮箱。
通过邀请链接注册?别删地址里的 aff 参数——你会多得一份奖励额度;你完成首次调用后,邀请人的奖励也会解锁。
在模型广场选模型
模型广场 列出了当前全部在售模型。这一步只为拿到两样东西:模型 ID 和它所在的分组。
分组
界面示意,以实际页面为准
- 1先按分组筛选。名称后面的
x0.2就是折扣——官方价的 2 折。 - 2点模型名右侧的复制按钮,得到完整模型 ID,例如
gemini-3.8-flash。 - 3卡片上直接显示该分组下的实付价(每百万 Token)和实时状态、延迟。
别猜模型名。客户端里填的模型 ID 必须和广场上的一字不差——不要自己增删后缀或改大小写。
创建 API 密钥
进入控制台的 API 密钥 页面,新建一把密钥。分组是这里唯一需要想一下的选项。
创建 API 密钥
sk-Qx7f••••••••••••••••••••3aK9复制密钥界面示意,以实际页面为准
- 1点右上角「创建 API 密钥」。
- 2名称随意,方便自己辨认即可,例如「首次测试」。
- 3分组决定这把密钥能调哪些模型、按什么折扣计费。第一次测试选「Gemini反重力专属」,全站最便宜。
- 4额度建议先设小一点(如 $5),用作这把密钥的消费上限。
- 5提交后立即复制以
sk-开头的密钥并妥善保存。
分组怎么选
| 我想… | 推荐分组 | 折扣 |
|---|---|---|
| 日常对话、长文、生图,或大批量跑量 | Gemini反重力专属 | 2 折 |
| 写代码、做分析、要模型认真想 | opus4.6专属(带思考的 Opus 4.6) | 3.5 折 |
| 用 Claude Code 做重度编程,要最新的 Opus 5.5 / Fable 5 | Claude 编程满血 | 4 折 |
| 要原生满血品质,或需要 Sonnet / Haiku | Claude 满血尊享 | 2.5 倍 |
| 用 GPT / Codex | GPT 高性价比 / GPT 不降智 | 2.4 折 / 4 折 |
完整分组与模型对照见 模型与价格。一个账户可以建多把密钥,不同用途用不同分组。
余额不够?到 钱包 在线充值:易支付,最低 $1,秒到账。
发第一个请求
选一种你顺手的方式,把 你的Key 换成刚复制的密钥,直接运行。
curl https://aiz.naiyouai.com/v1/chat/completions \
-H "Authorization: Bearer 你的Key" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3.8-flash",
"messages": [{"role": "user", "content": "请只回复:连接成功"}]
}'# pip install openai
from openai import OpenAI
client = OpenAI(api_key="你的Key", base_url="https://aiz.naiyouai.com/v1")
resp = client.chat.completions.create(
model="gemini-3.8-flash",
messages=[{"role": "user", "content": "请只回复:连接成功"}],
)
print(resp.choices[0].message.content)// npm install openai
import OpenAI from "openai";
const client = new OpenAI({ apiKey: "你的Key", baseURL: "https://aiz.naiyouai.com/v1" });
const resp = await client.chat.completions.create({
model: "gemini-3.8-flash",
messages: [{ role: "user", content: "请只回复:连接成功" }],
});
console.log(resp.choices[0].message.content);# Windows PowerShell
$body = @{
model = "gemini-3.8-flash"
messages = @(@{ role = "user"; content = "请只回复:连接成功" })
} | ConvertTo-Json -Depth 5
Invoke-RestMethod -Uri "https://aiz.naiyouai.com/v1/chat/completions" -Method Post `
-Headers @{ Authorization = "Bearer 你的Key" } `
-ContentType "application/json; charset=utf-8" `
-Body ([System.Text.Encoding]::UTF8.GetBytes($body)){
"object": "chat.completion",
"model": "gemini-3.8-flash",
"choices": [
{ "message": { "role": "assistant", "content": "连接成功" }, "finish_reason": "stop" }
],
"usage": { "prompt_tokens": …, "completion_tokens": …, "total_tokens": … }
}看到 "content": "连接成功",说明账户、余额、分组、模型四样都没问题。
Windows 用户注意:cmd 不支持示例里的单引号写法,请切到「PowerShell」或「Python」标签页。
接入常用客户端
不写代码也能用。各类客户端只需要填两样:地址和密钥。唯一的坑是地址要不要带 /v1:
| 客户端 | API 地址 | 说明 |
|---|---|---|
| Claude Code | https://aiz.naiyouai.com | 不带 /v1 |
| Codex · OpenAI SDK | https://aiz.naiyouai.com/v1 | 带 /v1 |
| Cherry Studio 等桌面客户端 | https://aiz.naiyouai.com | 客户端会自动补全路径 |
Claude Code
设置四个环境变量后启动。推荐使用「Claude 满血尊享」分组的密钥——Opus、Sonnet、Haiku 都在这个组,Claude Code 的主模型和后台小模型都能调到。若用「Claude 编程满血」的密钥,把两个模型变量都填成 claude-opus-5-5。
# macOS / Linux:写进 ~/.zshrc 或 ~/.bashrc 可长期生效
export ANTHROPIC_BASE_URL="https://aiz.naiyouai.com"
export ANTHROPIC_AUTH_TOKEN="你的Key"
export ANTHROPIC_MODEL="claude-opus-5-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
claude# Windows PowerShell(当前窗口生效)
$env:ANTHROPIC_BASE_URL = "https://aiz.naiyouai.com"
$env:ANTHROPIC_AUTH_TOKEN = "你的Key"
$env:ANTHROPIC_MODEL = "claude-opus-5-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-4-5"
claudeCodex
在配置文件里添加一个自定义服务商,密钥需属于 GPT 分组。
# ~/.codex/config.toml
model = "gpt-6-sol"
model_provider = "fuguang"
[model_providers.fuguang]
name = "FuGuang AI"
base_url = "https://aiz.naiyouai.com/v1"
wire_api = "responses"
env_key = "FUGUANG_API_KEY" # 然后: export FUGUANG_API_KEY="你的Key"Cherry Studio
在「设置 → 模型服务」里添加一个 OpenAI 兼容服务,其它桌面客户端的填法基本一致。
添加模型服务 · OpenAI 兼容
设置 → 模型服务 → 添加
界面示意,以实际页面为准
- 1API 密钥:粘贴你的
sk-密钥。 - 2API 地址:填
https://aiz.naiyouai.com,不要带/v1。 - 3模型:手动添加从广场复制的模型 ID,保存后即可对话。
查看使用日志
每次调用都会在 使用日志 里留下一行,用来核对有没有调通、花了多少。
界面示意,以实际页面为准
- 1一行就是一次调用:对一下模型、输入 / 输出 Token 数和费用。费用 = 官方价 × 分组折扣。
恭喜,上手完成。接下来可以看 接口文档 了解流式输出、Responses 与 Claude Messages。
调不通?按这个顺序查
返回 401 Invalid token
密钥填错、被删除,或请求头少了 Bearer 前缀。回到 API 密钥 重新复制一次。
返回 503 model_not_found · No available channel
两种可能:模型 ID 写错了,或这把密钥的分组里没有该模型。到广场原样复制模型 ID,并确认它属于你密钥的分组;不属于就换一把对应分组的密钥(对照见《模型与价格》)。
提示额度不足
账户余额和密钥自身的额度都要够。先看 钱包 余额,再看这把密钥设置的额度上限。
客户端连不上 / 404
多半是地址问题:Claude Code、Cherry Studio 不带 /v1;Codex、OpenAI SDK 要带 /v1。对照上面第 5 步的表格检查。
回复很慢或中断
到模型广场看该模型的实时状态与延迟,必要时换一个同级模型;长回复建议开启流式输出。
还是没解决?
联系 Telegram 客服,附上报错信息和脱敏截图——不要发送完整密钥。