wopally 使用手册：从注册到用上

第 1 步注册账号

打开 https://api.wopally.cn，点右上角「登录」：

第一次用先注册：填邮箱和密码（至少 6 位），邀请码没有可以不填，点「继续」：

随后邮箱会收到 6 位验证码，填进去点「验证并创建账户」即注册成功。收不到先看垃圾邮件。

注册成功直接进控制台，新用户有少量体验金可以直接试用：

第 2 步充值

点左侧「充值/卡密兑换」：在官方店铺（页面上的「去店铺购买」按钮）买卡密，回本页输入卡密点「兑换」，余额和并发数立刻到账：

第 3 步创建 API 密钥（Key）

点左侧「API 密钥」→「创建密钥」：

弹窗里只有三件事要注意：

1. 名称：随便起，方便自己认（比如 claude-日常）；
2. 平台：点 Claude / GPT / DeepSeek 之一——必须和想用的模型对应；
3. 分组：倍率越低越便宜，每个分组能用的模型写在描述里。

第 4 步一键复制配置（懒人通道）

Key 列表里每把 Key 后面都有「使用密钥」按钮——点开选你的软件，配置自动生成，复制粘贴即可：

Claude Code 的配置：

Codex CLI 的配置：

第 5 步请求地址怎么填（最容易错）

① Claude Code

方式 A：永久生效（推荐）

保存为 %USERPROFILE%\.claude\settings.json（Windows）或 ~/.claude/settings.json（Mac/Linux），Key 换成自己的：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.wopally.cn",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key",
    "ANTHROPIC_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

保存后重开 Claude Code。4 个模型变量都填同一个站内可用模型名，可避免它内部切小模型时报错。

方式 B：临时验证（当前窗口有效）

$env:ANTHROPIC_BASE_URL = "https://api.wopally.cn"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的Key"
$env:ANTHROPIC_MODEL = "deepseek-v4-flash"
claude -p "Reply with exactly: OK"

模型名换成你分组里实际有的。实测效果：

② Codex CLI

写两个文件（Windows 在 C:\用户\你的用户名\.codex\，Mac/Linux 在 ~/.codex/）：

config.toml：

model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
disable_response_storage = true

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.wopally.cn/v1"
wire_api = "responses"
requires_openai_auth = true

auth.json：

{ "OPENAI_API_KEY": "sk-你的Key" }

验证：codex exec "Reply with exactly: OK"，看到 OK 就通了：

③ zcode（桌面版）

zcode 在「设置 → 模型设置」里配置，全程图形界面：

1. 打开模型设置，点「添加供应商」：

2. 按下面四项填写（重点：API 格式选 Chat Completions，地址带 /v1）：

API 格式一共三个选项，别选错：

3. 点「+ 添加模型」，模型 ID 手动填（如 deepseek-v4-flash），保存：

4. 保存后显示「已启用」：

5. 回聊天页，点底部模型选择器，选 wopally / deepseek-v4-flash：

6. 发条消息测试，正常回复即接入成功：

④ WorkBuddy / Cherry Studio / ChatBox（通用 OpenAI 兼容）

这类软件全是同一套填法——设置里找到「自定义模型 / 模型服务商 / API 配置」，选 OpenAI 兼容：

保存后发条消息测试即可。若软件支持「拉取模型列表」，点一下会自动列出全部可用模型。

⑤ DeepSeek

想用 DeepSeek 的模型（deepseek-v4-flash、deepseek-v4-pro 等），有三种常见玩法：

玩法 A：官方风格的工具 / SDK（推荐）

DeepSeek 的接口就是标准 OpenAI 兼容格式，所以任何支持「自定义 OpenAI 接口」的软件都能把 wopally 当 DeepSeek 官方 API 用，三件套：

Python 代码示例（openai SDK，和官方 DeepSeek SDK 写法一致）：

from openai import OpenAI

client = OpenAI(
    base_url="https://api.wopally.cn/v1",
    api_key="sk-你的Key",
)
resp = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

玩法 B：ChatBox / Cherry Studio 这类聊天软件

• ChatBox：设置 → 添加自定义模型提供商 → API 类型选 OpenAI 兼容 → 按上面三件套填，模型名手动输入 deepseek-v4-flash；
• Cherry Studio：设置 → 模型服务 → 添加提供商，API Host 填 https://api.wopally.cn/v1，Key 填好后在模型列表手动添加 deepseek-v4-flash。

玩法 C：DeepSeek 官方 App / 网页版

⑥ Henness 等其他工具（没列到的都看这里）

没在上面列到的软件（Henness 或其他），不用慌——所有 AI 工具的接入方式就两类，对号入座：

配好后发条消息测试；报错直接查上面的报错速查表。

⑦ 其他 Claude 协议工具（cc-switch / ccs 等）

供应商切成自定义，三件套：地址 https://api.wopally.cn（不带 /v1）＋ Key ＋ 模型名。其余同 Claude Code。

我能用哪些模型？（2026-09 实测快照）

点站内「模型广场」随时看最新列表和价格，按 Claude / GPT / DeepSeek / Grok 四色分类：

套餐用户：套餐开通后用套餐专属 Key，只能调套餐内的模型。

报错了怎么办

先对着这张图找你的情况：

⚡ 报错关键词速查（点一下直达）

📡 站内近 7 天真实报错扫描（2026-09-13 自动汇总）

以下数据直接来自站内错误日志（近 7 天共 22,068 条记录），按你实际会遇到的情况归类。先说结论：其中约 7 成被站内自动换通道恢复，你最多感觉卡几秒，无需处理；真正会落到你屏幕上的主要是下面这些：

📏 上下文超长（400）

报错原文类似 This model's maximum context length is 262144 tokens. However, you requested …：输入+输出加起来超过了模型上限。→ 精简对话/文档、把 max_tokens 调小（比如 8192）、超长材料分段粘贴；需要超长上下文就选限制更大的分组模型。

🚫 This group does not allow /v1/messages dispatch（403）

你用 Claude 协议（/v1/messages）去调一个不支持该入口的分组。→ 把软件的接口方式改成 OpenAI 兼容（/v1/chat/completions，地址带 /v1），或者换一个支持 messages 的分组的 Key（如「国模福利Claude」）。

🛡️ 内容被拒（400）

inference request is invalid（上游校验拒绝）或 data_inspection_failed（内容安全审核）。→ 调整提问措辞、去掉敏感内容后重试；同一内容反复被拒就换个模型试试。

🔑 Invalid API key（401）

Key 填错、被删、或用错了分组的 Key。→ 回「密钥」页重新完整复制 sk- 开头整串；检查 Key 和要调的模型是不是同一个分组。

📛 模型不存在（404）

Model "xxx" is not supported by any configured account in this group —— 模型名写错，或这个分组没有这个模型。
model xxx not in whitelist（403）—— 该 Key 的分组没开放此模型。
→ 去「模型广场」核对模型名（一个字母都不能差）；换分组对应的 Key。

⚠️ 端点用错（400）

This model is not supported on the Chat Completions endpoint —— 请求发错了端点。→ Claude Code 走根地址（自动 /v1/messages），Codex 走 /v1/responses，普通软件走 /v1/chat/completions。对照第 5 步的图检查 Base URL。

⏳ 订阅调用次数已用尽，请购买新的套餐。（429）

套餐当日次数用完。→ 每天凌晨 0 点自动恢复；急用就续费。

⏳ 限流类（429）

rate_limit_exceeded（带 Retry-After）—— 触发限速（每分钟请求数、Key 周期限额等），按提示秒数等一下再试。
Too many pending requests, please retry later —— 高峰期站内排队满，等 10~30 秒。
Upstream rate limit exceeded, please retry later —— 上游模型限流（站里已自动换过通道），等 30 秒~几分钟。别狂点重发。

🌊 上游波动（502 / 503）

Upstream request failed / Upstream service temporarily unavailable / All available accounts exhausted（502）—— 上游通道波动（实测 gpt-5.6-sol 偶发，换 gpt-5.5 立刻通）。
No available accounts / Service temporarily unavailable（503）—— 分组暂时没有可用通道。
→ 等 1~5 分钟重试或换个模型，配置什么都不用改。

🌊 credit insufficient balance（400）

不是你的余额问题——是站方该分组的上游号临时没额度了，管理员会处理。→ 换个分组/模型，或在问题反馈页吱一声。

🔌 Connection refused — a firewall or proxy may be blocking it

你本地的代理问题（梯子没开但系统代理还开着，或代理软件挂了）。wopally 国内直连不需要梯子。→ 关系统代理，或在代理软件里给 api.wopally.cn 设置直连。

流式中途报错（聊着聊着断了）

流式请求一旦开始，HTTP 状态码已是 200，错误会以 error 事件出现在输出里，对照上面同样处理。

计费与省钱须知

• 错误不计费：所有失败请求（401/404/429/5xx）都不产生费用；
• 超长上下文加倍：单次输入超过 272K tokens，该请求按 输入×2 / 输出×1.5 / 缓存×2 计费——超长文档建议分段；
• 固定用同一把 Key 更便宜：站内会把你的会话固定在同一通道，上下文缓存命中率更高，缓存部分单价远低于普通输入；
• 套餐每日 0 点重置次数。

还是不行？自查清单

1. Base URL 带不带 /v1 搞对了？（第 5 步那张图）
2. Key 的分组和模型对得上吗？（claude 分组的 Key 调不了 deepseek）
3. 模型名是从模型广场抄的吗？（gpt-5.2 已下线）
4. 配置文件保存后重启软件了吗？
5. 梯子是不是开着/挂着？（关掉试试）
6. 余额 / 套餐次数还有吗？

问题反馈

以上都确认过还不行：到站内「问题反馈」页提交，或加页面右侧的 QQ 群，附上 时间 + 模型名 + 报错截图，处理最快：