计费规则与错误码
token 计费公式、分组倍率、账单核对方法，以及 401/404/429/5xx 错误的排查顺序与重试策略。
计费公式
按 token 计费的模型：
本次费用 = 模型基础价 × 分组倍率 × token 用量- 模型基础价：价格页展示的「美元/百万 tokens」，输入输出分开计价
- 分组倍率：default = ×1.0；Claude官转 / OpenAI官转 / Gemini优质 = ×1.5
- 平台会在计量时按模型 tokenizer 换算，与你本地估算可能有 ±5% 以内的差异
按次计费的模型（图像 / 视频 / 3D）：直接按价格页标注的「$/次」扣除。
账单核对三步法
- 控制台 → 日志，找到目标调用，确认模型名、分组、时间
- 用响应里的
usage（prompt_tokens / completion_tokens）乘价格页单价 - 与扣费记录对比；有出入优先检查是否走了非 default 分组
分组说明
| 分组 | 倍率 | 说明 |
|---|---|---|
| default | ×1.0 | 全模型可用，首选 |
| Claude官转 | ×1.5 | 纯官方渠道 Claude，稳定性优先 |
| OpenAI官转 | ×1.5 | 纯官方渠道 OpenAI |
| Gemini优质 | ×1.5 | Gemini 优质渠道，视频分析完整支持 |
错误码速查
| 状态码 | 含义 | 处理 |
|---|---|---|
| 401 | Key 无效或格式错误 | 检查 sk- 前缀、空格、是否被禁用 |
| 403 | 无该模型/分组权限 | 控制台确认分组与模型可用性 |
| 404 | 模型名不存在 | 从模型页复制准确名称 |
| 429 | 触发限流 | 指数退避重试；持续出现联系客服提额 |
| 500/502/503 | 上游渠道异常 | 自动切换渠道；重试 2–3 次 |
| 请求超时 | 长文本或上游慢 | 流式 + 更短 max_tokens |
错误响应体格式：
{
"error": {
"message": "该令牌无权使用模型 xxx",
"type": "forbidden"
}
}重试模板
import time, random
def with_retry(fn, attempts=4):
for i in range(attempts):
try:
return fn()
except Exception as e:
status = getattr(e, "status_code", None)
if status in (429,) or (status and status >= 500):
wait = (2 ** i) + random.random()
time.sleep(wait)
continue
raise
raise RuntimeError("retries exhausted")原则：只重试「幂等且可能恢复」的错误（429、5xx）；400/401/404 重试没有意义，直接修配置。
成本控制清单
- 给所有调用设置
max_tokens - 系统提示词保持前缀稳定，命中提示缓存
- 高频场景优先 default 分组低价模型
- 控制台按天看用量曲线，异常尖峰当天排查
有对账问题请通过联系页的客服或邮箱反馈，附上时间、模型名与日志截图。