常见问题与排查完整版

按错误类型对号入座。定位到问题前，先确认三件事：① 地址是不是 https://api.mywanto.info；② Key 是不是完整复制；③ 余额是否充足。 这三项能解决 80% 的问题。

401 / Invalid token（认证失败）

含义：服务端不认你的 Key。

Key 复制不全 → 回「API 密钥」列表重新点复制，别手打；
多/少字符或混入空格 → 粘贴后检查首尾无空格；
令牌被禁用/删除 → 检查令牌状态是否为「已启用」；
Key 填错字段 → 有的客户端要填在 API Key，不是 Organization ID；
刚创建就报错 → 等 10 秒让系统同步，或重新复制一次。

404 / 301（地址错误，最常见）

含义：请求到了错误的路径或发生了跳转。

错误写法	问题	正确写法
`http://47.76.28.128`	裸 IP 无 HTTPS 证书	`https://api.mywanto.info`
`https://api.mywanto.info:3000`	3000 是内部端口，未对外开放
`http://api.mywanto.info`	纯 http 部分客户端不认跳转

💡 一句话：一律填 https://api.mywanto.info（OpenAI 系），或 https://api.mywanto.info/v1（部分客户端要求带 /v1）。

403 / 无权限

你的 Key 所属分组没有权限调用该模型 → 联系管理员确认分组与模型授权；
账号被限制（欠费/违规）→ 检查账号状态。

429 / Too Many Requests（请求过多）

单分钟内请求太密集 → 降低并发、稍等重试；
长时间大批量任务 → 加延时或错峰执行；
上游限流 → 一般等 10~30 秒自动恢复。

余额不足 / 消耗过快

「钱包」页查看余额；不足 → 到发卡站补购兑换码：购买兑换码；
思考型模型（gpt-5.6-sol、opus）比普通模型消耗快，属正常；
用「日志」页看单次请求的模型 / Tokens / 扣费，定位大额消耗来源；
开了多个客户端同时跑，也会加快消耗。

模型不可用

报错	原因	解决
`model not found`	模型名写错 / 该模型未在你的分组开放	从「模型广场」复制模型名；联系管理员开权限
`No available channel`	该模型在分组内无可用渠道	联系管理员（渠道/分组配置问题）
请求包含不支持参数	如发了官方不支持的 temperature	看配置教程里的建议参数

连不上 / 超时 / 转圈

先刷新重试：瞬时波动偶发超时正常；
网络因素：节点在境外，部分网络（企业内网/校园网）访问不稳，可换热点/流量试；
长回复被断开：单次对话太长或网络抖，可把任务拆小、分段执行；
代理冲突：开了 VPN/代理有时反而连不上，可临时关掉试；
还不行？带完整报错截图 + 大概时间联系管理员。

API 接口（开发者用）

所有请求把 {key} 换成你的 Key（Authorization: Bearer sk-xxx）。

功能	接口	协议
模型列表	`GET /v1/models`	OpenAI
对话补全	`POST /v1/chat/completions`	OpenAI
Responses（Codex 用）	`POST /v1/responses`	OpenAI Responses
Claude 消息	`POST /v1/messages`	Anthropic

# 快速验证 Key 是否可用
curl https://api.mywanto.info/v1/models \
  -H "Authorization: Bearer sk-你的Key"

# 发一条对话
curl https://api.mywanto.info/v1/chat/completions \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"你好"}]}'

计费与余额说明

余额按调用量实时扣减，扣费 = 模型价格 × 实际 Tokens；
「日志」页可查每一次请求的扣费明细；
余额不清零、不设有效期；充值比例以购买页标注为准。

充值与开票

充值流程：发卡站下单（支付宝/微信自动发码）→ 控制台「钱包」粘贴兑换码兑换；
开票：如需中国大陆发票，请在付款前联系客服确认，美元在线支付订单默认仅提供付款凭证；
大额/企业用户可联系管理员走对公或批量优惠。

常见问题与排查 完整版