常见问题与报错码
按你看到的错误(HTTP 状态码 / 错误信息)查找。
报错码速查
| HTTP | 含义 | 常见原因 | 怎么办 |
|---|---|---|---|
| 401 | 鉴权失败 | Key 错 / 多了空格 / 渠道平台不对 | 重新复制 Key;检查 Key 绑的渠道是不是匹配你的客户端协议 |
| 403 | 没权限 | 该 Key 被禁用 / 余额为 0 | 后台看 Key 状态、看钱包余额 |
| 404 | 路径不存在 | base URL 写错 / 多了或少了 /v1 | 看各客户端的精确 base URL |
| 429 | 服务限流 | 短时间内请求过密 | 等 1–5 分钟自动恢复 |
| 500 | 服务器错 | 服务端临时异常 / 偶发 | 重试一次。持续出现联系客服 |
| 502 / 503 | 服务暂不可达 | 服务端故障切换中 / model 名填错(如 gpt-5 没加版本号) | 看 model 字段是否精确 / https://claude-api.org/status |
| 504 | 请求处理超时 | 单次请求太长 / 模型在思考 | 缩短 prompt、关闭流式、换更快的模型 |
常见问题
我用这个调出来的模型和官方一样吗?
完全一样。模型权重、推理过程、输出内容都由模型方服务器原生返回。我们不替换、不裁剪、不掺水。
我刚注册了,新人体验金没到账?
新人体验金分两段:
- $1 立即到账:完成邮箱验证后发放(点邮件里的验证链接);到账延迟最多 5 分钟
- $9 绑 Telegram 后到账:在 TG 群 私聊 @ClaudeAPIAPIbot 发
/bind <你的 6 位绑定码>(绑定码在后台 → 个人资料 → 加 Telegram 群领赠金 处生成)
仍未到账 → 联系 [email protected] 附注册邮箱。
余额 $ 是不是美元?我充 ¥100 显示 $100 是不是 bug?
不是 bug。我们站点货币显示统一为 $(USD),充值时 ¥1 = $1。你充 ¥100 = 余额 $100。计算余额直接看 $ 数即可,无需换算。
一个 Key 能调多个渠道吗?
不能。每个 Key 创建时绑一个渠道,只能调那个渠道的模型。
要跨渠道用:创建多个 Key,每个绑不同渠道。常见组合:
- 一个 Key 绑
Claude 官方(仅限claude code)给 Claude Code CLI 用 Opus(1.4x,高质量上游) - 一个 Key 绑
Claude 官方(不限客户端)给 Cline / Cursor 调 Claude / opencode 等用(2.0x,不限客户端) - 一个 Key 绑
Claude AWS Bedrock给生产关键的 Claude 工作流用(3.0x,AWS Bedrock 上游高可用) - 一个 Key 绑
低价claude给任意客户端用,追求最低价(0.5x,质量相对不稳定) - 一个 Key 绑
Claude sonnet 折扣给 Sonnet 主力工作流用(0.5x 更便宜) - 一个 Key 绑
Codex给 Cursor / Codex CLI 用(0.35x,纯文本) - 一个 Key 绑
Codex 超低价给生图 / 想最省钱场景用(0.15x,含 gpt-image-2) - 一个 Key 绑
Gemini给图像理解 / 长文本场景用
API Key 不限数量。
邀请返利怎么算?
- 你邀请 A 注册并充值
- A 之后 90 天内的所有消费,你自动获得 15% 返佣到余额
- 单个被邀请人最多给你带 $20 的返佣
- 返佣有 72 小时冻结期(防恶意刷退)后到账可用
详见后台的"邀请页面"。
我拿到 503 No available accounts
最常见两种情况:
model字段填错了(最常见)—— 我们没做短名兜底,必须填精确名:- ❌
gpt-5、claude-opus、gemini-pro - ✅
gpt-5.4、claude-opus-4-8、gemini-3-pro-preview
各渠道的精确模型清单见 渠道与价格。比如 Codex CLI 默认会发
gpt-5,需要在客户端配置里把 model 显式改成gpt-5.4或gpt-5.5。- ❌
该渠道全部账号正在故障切换:稍后重试,或看 https://claude-api.org/status
为什么我的请求会偶发 429 然后等几分钟自动好?
为保证服务长期稳定,我们的调度系统会自动控制单位时间内的调用量。
短时间内请求过密时,部分请求会暂时返回 429,1–5 分钟内自动恢复。这是为了让所有用户长期都能用得上。
如果你的工作流对偶发 429 敏感,建议:
- 在客户端实现简单的指数退避重试
- 错峰使用(避开 19:00–23:00 高峰)
- 重要任务多 Key 轮换
我的对话内容会被你们存下来吗?
对话正文不存。我们的服务端日志只包含计费维度元数据:
- 时间戳
- 调用模型
- input / output token 数
- HTTP 状态码
- 你的 Key ID
正文(messages、prompt、response)走 stream 转发后立即抛弃,不写盘。详见 用户协议。
我的钱安全吗?
我们的资金管理三条原则:
- 不囤资金:充值进来的余额我们尽快用于运营成本,不把用户的钱长期沉淀
- 不鼓励大额充值:所以建议 单次 ≤ ¥500
- 运营信息透明:邮箱 [email protected];Telegram 群 https://t.me/+Lfq1A_3e6BRhNjE5
如果你只是想试用,先用注册送的 $1 + 加 TG 群再领 $9 跑通流程再决定要不要充值。
充了不想用想退款
可以。详见 退款政策 — 0–30 天扣通道手续费,30–90 天扣 5%,服务异常全额退。
可以开发票吗?
支持对公开具发票,适用于国内对公客户(仅限中国大陆,暂不支持为境外客户开票)。
- 需要开票请联系客服办理,提供抬头、税号等开票信息
- 通过「直接充值」自助完成的订单不支持开票;如需发票,请在充值前联系客服
- 客服渠道:邮箱 [email protected] / 后台工单
SSE 流式相关
Claude Code / Cursor 流式中途断掉
国内运营商对长 SSE 连接的中间设备会超时(一般 60–120s)。我们尽力保活:
- 定期发心跳 keep-alive 包
- 触发自动断流时会重连
但极端网络下还是可能断。临时方案:
- 关闭流式:
ANTHROPIC_NO_STREAM=1(Claude Code)/disable_streaming: true(Cursor) - 切到电信 / 联通线路(移动用户偶发更差)
- 用 mosh / tmux 等持久会话工具隔离短暂断连
流式输出乱码
- 终端没设 UTF-8(Windows)→
chcp 65001 - 客户端版本太老 → 升级到最新
图像生成 / AI 图像生成工具
怎么生图
两种方式:
直接调 API:
POST /v1/images/generations,model 选gpt-image-2。API Key 必须绑定到Codex 超低价渠道(目前只有该渠道开了生图)。请求格式与 OpenAI 官方一致:bashcurl https://claude-api.org/v1/images/generations \ -H "Authorization: Bearer sk-..." \ -H "Content-Type: application/json" \ -d '{"model":"gpt-image-2","prompt":"a cat in a spacesuit, sticker style","size":"1024x1024"}'后台内嵌工具:登录 https://claude-api.org/ → 侧边栏「AI 图像生成」。在该页选你已有的 Key + 输入 prompt 即可生成,支持上传参考图改图。prompt 和参考图会自动保存,切页/刷新不丢。
生图被拒"Image generation is not enabled for this group"
你用的 Key 绑定的不是 Codex 超低价 渠道。其他 OpenAI 渠道(Codex 0.35x)以及 Gemini 渠道当前都没开图像生成权限。换一个绑了 Codex 超低价 的 Key 即可。
工单(支持)
工单消息可以传图片吗?
可以。新建工单和回复时都能附图(最多 3 张),适合贴报错截图、客户端配置、控制台画面。图片会自动压缩,管理员在工单里直接看图回复。点击图片可放大查看。
我提交工单后,管理员回复时怎么通知我?
两个通道同时发,你不用都接:
- 邮件:管理员一回复,你注册邮箱会收到通知,正文含工单链接 + 回复内容预览(直接打开链接看完整对话)
- Telegram 推送:如果你已经绑定 TG bot,会收到 bot 私聊消息
两条通道独立,任一通到就够。如果两个都没收到,联系 [email protected] 报问题。
Gemini 渠道相关
Gemini 报 400 "Request contains an invalid argument" 怎么办
99% 是请求体里 contents item 缺了 "role": "user" 字段。Google AI Studio / Code Assist 当前版本强制要求每个 content 显式带 role,缺了立即 400。
❌ 会被拒:
{"contents":[{"parts":[{"text":"hi"}]}]}✅ 正确:
{
"contents": [
{"role": "user", "parts": [{"text": "hi"}]}
]
}多轮对话时 assistant 那一轮用 "role": "model":
{
"contents": [
{"role": "user", "parts": [{"text": "你好"}]},
{"role": "model", "parts": [{"text": "你好!"}]},
{"role": "user", "parts": [{"text": "再见"}]}
]
}如果你用 Google 官方 SDK(@google/genai / google-genai-python 等),SDK 会自动加 role,遇到 400 优先排查是不是手写 raw JSON 漏字段;少数第三方 API 检测器也会发缺 role 的 payload,那是检测器本身的 bug。
Gemini 调用要走哪个 base URL / 端点
Gemini 渠道不走 OpenAI / Anthropic 兼容协议,只走 Google 原生 /v1beta/models/... 端点:
POST https://claude-api.org/v1beta/models/gemini-3.1-pro-preview:generateContent
POST https://claude-api.org/v1beta/models/gemini-3.1-pro-preview:streamGenerateContent?alt=sseHeader 用 Authorization: Bearer sk-...(不是 x-goog-api-key)。流式响应是标准 SSE。
Gemini 拿到 503 "no available accounts"
可能两种:
- model 名不在 Gemini 官方支持列表:比如用了
gemini-2.0-flash/gemini-2.5-flash-image等当前未上架的名字 → 改用列表里的 5 个名字之一 - 该渠道账号短暂自愈中(OAuth token 偶发刷新失败会触发 10min 隔离)→ 1 分钟后重试,或看 https://claude-api.org/status
工具调用 / Function Calling
tool 调用循环 / 模型反复调用同一个工具
通常是协议适配问题。Codex / Codex 超低价 两个 OpenAI 渠道都同时支持 Responses(Codex CLI 走的)+ ChatCompletions(Cursor / Cline / Chatbox 走的)两条 path —— 大多数客户端选 ChatCompletions 更稳定。处理:
- 客户端配置里改用 ChatCompletions 端点(
/v1/chat/completions而不是/v1/responses) - 或切到 Claude 渠道(Claude 的工具调用更稳定)
工具返回的 JSON 被截断
max_tokens设太小 → 调到 4096+- 模型选错 → mini 模型 JSON 输出能力弱,换
gpt-5.4或claude-sonnet-4-6
还没解决?
按下面顺序找帮助:
- 本 FAQ + 文档站 搜一搜 — 大部分问题(401 / 429 / 模型名 / 协议适配)都在这里
- 开工单: 后台 → 左侧栏「工单」→ 新建 → 选「问题反映」→ 描述清楚(贴 curl / 错误码 / 模型名)
- 工单回复会通过邮件 + Telegram(已绑) 推送给你
- 提「建议」类型的工单被采纳实际上线后,赠 ¥20–100 余额作为感谢
- Telegram 群: https://t.me/+Lfq1A_3e6BRhNjE5 — 群内成员可私聊 @ClaudeAPIAPIbot 查余额、用量、API key
- 邮件兜底: [email protected](支付/账户安全/法律相关用邮件)
