DOCS
使用文档
由纪:「看不懂的地方,直接问我也行。」
快速开始
- 注册账号,注册即送试用额度;余额不够时到 控制台 · 充值。
- 到 API 密钥 选「模型家族 + 档位」新建一把密钥,复制
sk-开头的那串。 - 把 接入地址 和 密钥 填进你的工具,模型名照 价格页 上的写。
一把密钥只能调用它所在档位里的模型。想同时用 Claude 和 GPT,就建两把。
个人档与专业档
每个模型家族(Claude、GPT、Gemini、Grok、国模、各家生图)都分两档:
- 个人:价格最低,适合自己日常聊天、写作、学习。高峰期偶尔需要稍等。
- 专业:更稳定、并发更高,适合 Claude Code / Codex 长时间编程、团队共用、接入业务。
Claude 个人档有两条线路:Kiro 线路最便宜;CCMax 线路走官方订阅号池,体验更接近原生。建密钥时选其中一个即可。
接入地址
| 用途 | 地址 |
|---|---|
| OpenAI 兼容(绝大多数工具) | |
| Anthropic 原生(Claude Code) | |
支持的接口:/v1/chat/completions、/v1/messages、/v1/responses、/v1/images/generations、/v1/embeddings、/v1/models。
注意 Base URL 末尾:OpenAI 兼容的要带 /v1,Claude Code 的 不要 带 /v1,填错会 404。
Claude Code
用 Claude 家族的密钥(推荐专业档)。在终端里设置两个环境变量后启动:
macOS / Linux
export ANTHROPIC_BASE_URL=""
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
claude
Windows PowerShell
$env:ANTHROPIC_BASE_URL=""
$env:ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
claude
想固定模型,再加一行 export ANTHROPIC_MODEL="claude-sonnet-5-5"(模型名以价格页为准)。只在当前终端生效,不影响你原来的配置。
Codex CLI
用 GPT 家族的密钥。编辑 ~/.codex/config.toml,新增一个 provider:
model = "gpt-6-sol"
model_provider = "roleai"
[model_providers.roleai]
name = "RoleAI"
base_url = ""
env_key = "ROLEAI_API_KEY"
wire_api = "responses"
然后 export ROLEAI_API_KEY="sk-你的密钥",运行 codex。
Cherry Studio
- 设置 → 模型服务 → 添加,类型选 OpenAI(用 Claude 也可以选 Anthropic)。
- API 地址填
,API 密钥填sk-…。 - 点「管理」拉取模型列表,勾选要用的模型,保存。
Lobe Chat、ChatBox、NextChat 等聊天客户端同理:选 OpenAI 兼容,地址带 /v1。
Cursor / Cline / Continue
- Cursor:Settings → Models → 打开 OpenAI API Key,填密钥;展开 Override OpenAI Base URL,填
;再手动添加模型名。 - Cline / Roo Code:API Provider 选 OpenAI Compatible,Base URL 填带
/v1的地址,Model ID 填模型名。用 Claude 也可以选 Anthropic,并填自定义地址(不带/v1)。
Python / Node SDK
Python(openai 官方库)
from openai import OpenAI
client = OpenAI(base_url="", api_key="sk-你的密钥")
r = client.chat.completions.create(
model="claude-sonnet-5-5",
messages=[{"role": "user", "content": "帮我把这段话改得更正式"}],
)
print(r.choices[0].message.content)
Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "", apiKey: "sk-你的密钥" });
const r = await client.chat.completions.create({
model: "gpt-6-sol",
messages: [{ role: "user", content: "写一份周报提纲" }],
});
console.log(r.choices[0].message.content);
curl
curl /chat/completions \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{"model":"claude-sonnet-5-5","messages":[{"role":"user","content":"你好"}]}'
生图接口
用生图家族的密钥(GPT 生图 / Gemini 生图 / Grok 生图),调用 OpenAI 格式的生图接口:
curl /images/generations \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-image-2","prompt":"一只在办公桌上打盹的橘猫,二次元风格","size":"1024x1536","n":1}'
- 按次计费,价格见 价格页。生成失败不扣费。
- 出图一般 15–60 秒。客户端超时不等于失败,请不要立刻重发,否则可能重复扣费;先到控制台日志确认。
- 返回
b64_json或url,视模型而定。
角色对话
在 角色广场 选一个角色,点「开始对话」。站内对话使用你在 API 密钥 页「设为对话密钥」的那一把,按实际调用的模型扣费。对话记录只保存在你自己的浏览器里。
角色 Agent
下载到自己电脑上运行的办公助手:写文档、做表格、整理资料、写代码。外观和说话方式由你选的角色卡决定,默认连接本站账户,用量从余额里扣。正在开发中,上线后会在 角色 Agent 页提供下载。
计费规则
- 余额以 美元 计。文本模型按每 100 万 token 计价,输入、输出、缓存读分别计算。
- 扣费 =(输入 token × 输入单价 + 输出 token × 输出单价 + 缓存 token × 缓存单价)÷ 1,000,000。
- 部分模型输入超过一定长度会切到长上下文价格。
- 生图按次计费,请求失败不扣费。
- 每一笔调用都能在 控制台 · 使用日志 查到模型、token 数和扣费金额。
常见报错
| 报错 | 原因 | 怎么办 |
|---|---|---|
401 无效的令牌 | 密钥写错、被删或停用 | 到 API 密钥页复制完整的 sk-…,注意别带空格 |
403 额度不足 | 余额用完 | 到控制台充值 |
404 Not Found | Base URL 填错 | OpenAI 兼容要带 /v1,Claude Code 不带 |
| 无可用渠道 / model not found | 这个模型不在你密钥所属的档位里 | 换一个档位的密钥,或换成价格页上该档位有的模型名 |
429 请求过多 | 短时间并发太高 | 降低并发,或改用专业档 |
502 / 503 / 524 | 上游暂时不可用或超时 | 稍后重试;生图类先查日志再决定是否重发 |