DOCS

使用文档

由纪:「看不懂的地方,直接问我也行。」

快速开始

  1. 注册账号,注册即送试用额度;余额不够时到 控制台 · 充值。
  2. 到 API 密钥 选「模型家族 + 档位」新建一把密钥,复制 sk- 开头的那串。
  3. 把 接入地址 和 密钥 填进你的工具,模型名照 价格页 上的写。

一把密钥只能调用它所在档位里的模型。想同时用 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

  1. 设置 → 模型服务 → 添加,类型选 OpenAI(用 Claude 也可以选 Anthropic)。
  2. API 地址填 ,API 密钥填 sk-…。
  3. 点「管理」拉取模型列表,勾选要用的模型,保存。

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 FoundBase URL 填错OpenAI 兼容要带 /v1,Claude Code 不带
无可用渠道 / model not found这个模型不在你密钥所属的档位里换一个档位的密钥,或换成价格页上该档位有的模型名
429 请求过多短时间并发太高降低并发,或改用专业档
502 / 503 / 524上游暂时不可用或超时稍后重试;生图类先查日志再决定是否重发