常见问题
账号与账单
Q: 为什么充值后余额没到？
A: 兑换码是秒到；支付通道到账 1-5 分钟。超时未到刷新页面。仍无变化，把订单号 / 兑换码贴给管理员查。
Q: 我用完了 ¥5，为啥控制台显示 $0.68 剩下？
A: ¥7.3 = $1，¥5 ≈ $0.68。控制台默认按 USD 显示。
Q: 能开发票 / 收据吗？
A: 目前不主动开。如需，联系管理员说明抬头/税号 / 邮寄地址（或电子发票邮箱），会批处理开一次。
令牌与安全
Q: 我 Key 被泄露了！
A: 立即去控制台把这把 Key 禁用（不是删除），秒失效。然后建新 Key、切换你所有客户端到新 Key。再检查你的日志看有没有异常调用。
Q: 我怎么知道 Key 有没有被别人在用？
A: 控制台 → 日志 → 按 Key 筛选。看：源 IP 是不是全是你自己的、模型是不是你惯用的、有没有奇怪的时间段调用。异常就废掉。
Q: 一个 Key 能用多久？
A: 你自己设过期时间（-1 就是永远）。建议每 90 天轮转一次——建新 Key 客户端切换观察 1 周旧 Key 禁用。
Q: Key 显示成 sk-xxxx...yyyy 那种脱敏，我只想 copy 完整的？
A: 建 Key 那一刻页面唯一一次给你看完整 Key。之后要看：控制台 → 令牌 → 查看密钥 → 输密码。
模型与路由
Q: 报「无可用渠道」但我明明选了模型？
A: 你 Key 的分组没有支持这个模型的渠道。见 分组说明。
Q: 我调 claude-opus-4-8 应该选哪个分组？
A: 通用 Claude-Stable；如果频繁重用同 prompt / 长会话，用 Claude-ESpeed（带缓存）。
Q: Claude-Stable 和 Claude-ESpeed 是不是模型不一样？
A: 一样。只是渠道池不同。Stable 包所有 4 条 Claude 渠道，其中 1 条不带缓存；ESpeed 只走 3 条都带缓存的。价格一样（都是 4 折）。
Q: 我的响应慢，切分组能变快吗？
A: 大部分慢在上游模型推理，切分组只影响 5-15%。真要提速：换模型（Sonnet vs Opus）、缩 prompt、加 prompt cache。
客户端
Q: Claude Code 报 401？
A: 检查 ANTHROPIC_BASE_URL=https://api.modexflow.cc（没有 /v1）+ ANTHROPIC_API_KEY=sk-... 都在环境变量里。
Q: OpenAI SDK 显示 Incorrect API key？
A: 检查 base_url 里有 /v1：https://api.modexflow.cc/v1。少 /v1 就是 404。
Q: Cline 上传项目卡住？
A: Cline 大项目首次分析耗时 60-120s，属正常。之后有本地索引会快。
计费
Q: usage.completion_tokens 里的 reasoning_tokens 也算钱吗？
A: 算。DeepSeek Pro / GPT-5.5 的思考过程算 output tokens。所以给这些模型的 max_tokens 要留够（Claude/GPT 至少 500；DeepSeek Pro 至少 1000）。
Q: 缓存命中了，能省多少？
A: 命中部分的 input tokens 只算 10-25% 价钱（各上游具体折扣不同）。长会话 / 反复读同一份代码库能省 30-70%。
Q: 我请求失败也扣钱吗？
A:
- 请求还没到上游就报错（401/403/404/429）→ 不扣
- 请求到达上游但上游报错 → 一般不扣，个别情况会扣少量成本（比如上游已经开始生成再中断）
- 用户端主动断开中间流 → 扣到中断那一刻的量
Q: 大批量任务，怎么估费用？
A:
- 抽样 5-10 个真实 case，跑一遍拿到 usage 平均值
- 乘上总量
- 加 30% 冗余（防边缘 case）
集成 / 生态
Q: 支持 Dify / FastGPT / OneAPI 之类平台再套一层吗？
A: 支持。它们只要能填自定义 base_url + API Key，就能把 ModeXFlow 当作它们的一个「渠道」。
Q: 支持从 OpenRouter 迁移吗？
A: 支持，改 base_url。但模型名不同——你要把 OpenRouter 那边的 anthropic/claude-3-opus 改成我们的 claude-opus-4-8。用 模型列表 里的准确名字。
Q: 支持 embeddings / 图像 / 音频吗？
A: 协议上支持（/v1/embeddings、/v1/images/generations），但当前渠道池主要接 chat 模型。要用 embeddings/图像/音频请联系管理员开通对应渠道。
其他
Q: 状态页在哪？
A: https://www.modexflow.cc/api/status，返回 JSON。用于自动化监控。更详细的服务面板计划中。
Q: 服务端在哪里？
A: 香港（网关）+ 各上游分布全球。
Q: 数据会被记录吗？
A: 每次调用的 metadata（模型、tokens、request_id、时间、扣费）会被记录用于账单。请求正文和模型响应正文默认不落库（只在异常排查时可能临时抓样）。
Q: 服务什么时候会有中断？
A: 目标 99.9% 可用性。计划维护会提前 24h 通知（邮件 + 控制台公告）。非计划中断（上游全挂等）实时同步在公告栏。