SuperRoute 使用过程中最常被问到的问题
常见问题
找不到答案?👉 加入底部 QQ 群直接问。
账户与注册
如何注册 SuperRoute 账号?+
访问 superoute.uk/login,使用手机号或邮箱完成注册。注册后即可创建 API Key。
支持企业团队使用吗?+
支持。企业用户注册时使用企业邮箱即可。 团队规模大(>20 人)或有月结需求,请联系底部 QQ 群商务。
忘记密码怎么办?+
登录页点击「忘记密码」→ 通过注册手机/邮箱接收验证码 → 重置。 如果手机号也换了,请联系 QQ 群管理员协助。
充值与计费
支持哪些充值方式?+
充值通过商务渠道完成。加入底部 QQ 群联系商务获取充值方式与额度。
三档的具体价格是多少?+
请在 控制台 → 定价 按模型筛选查看。 每张模型的输入/输出价格在三个档位上分别显示。
余额不足会怎样?+
请求会立即返回 403 insufficient_quota 错误。
充值后无需等待,秒级恢复。
支持退款吗?+
支持。 我们推荐用户先小额购买体验。
如需退款,请加入底部 QQ 群联系商务,根据实际情况处理。
API Key
一个 Key 能用于 OpenAI 和 Anthropic 吗?+
不能。在创建 Key 时会绑定协议类型(OpenAI 兼容 / Anthropic 兼容)。 如需同时调用 GPT 和 Claude,请创建两个 Key。
Key 丢了怎么办?+
Key 仅在创建时显示完整明文,平台不存储。 丢失无法找回,只能重新创建并禁用旧 Key。 建议创建后立即保存到密钥管理工具(如 1Password、Vault)。
Key 会被盗用吗?泄露了怎么办?+
一旦怀疑泄露:
- 立即在控制台「接口密钥」页面禁用该 Key
- 创建新 Key
- 检查 用量明细 确认是否有异常调用
- 如有异常,可在控制台申请争议账单调整
一个 Key 只能选一个档位吗?+
是的。档位在创建 Key 时绑定,同一 Key 始终走同一档位通道。 如需使用多档,创建多个 Key 分别绑定即可。
三档通道
同一模型在三个档位下输出有差异吗?+
没有。 三个档位调用的是同一个模型,输出结果完全一致。 档位的差异不在模型本身,而在于:
- 底层通道的服务策略(限速、连接复用)
- 故障转移策略
- 价格
我应该选哪个档?+
详见 [分组定价与通道策略](/03-group-pricing) 的「场景速查」一节。简单总结:
- 批处理 / 压测 → ⚡ fast
- 生产环境 → 🛡️ stable
- 旗舰体验 → 🚀 full
- 不确定 → 默认选 🛡️ stable
三档混用怎么计费?+
每张 Key 独立计费,按 Key 创建时绑定的档位价格计算。 例:创建了 2 个 Key(1 个 fast + 1 个 full),调用时分别按 fast 和 full 定价计入总账单。
能临时切换档位吗?+
不能直接切换。需要:
- 创建新 Key(绑定到新档位)
- 停用旧 Key
- 把代码里的 Key 字符串替换为新 Key
也可保留两套 Key 在代码里,按场景动态选择。
限速与配额
默认限速是多少?+
不同档位的限速配额不同,具体以 控制台 显示为准。 一般来说 fast / full 档位配额更高,stable 档位更低但更稳定。
触发限速(429)怎么办?+
- 实现指数退避:1s → 2s → 4s → 8s 重试
- 降低并发:用信号量控制同时请求数
- 多 Key 分流:创建多个 Key 轮询使用
- 升级档位:fast / full 档位配额更高 详细重试代码见 报错与踩坑 → 客户端最佳实践
需要更大的额度怎么办?+
加入底部 QQ 群联系商务提交额度申请。
接口调用
怎么调用流式?+
OpenAI:在请求体加 "stream": true
Anthropic:在请求体加 "stream": true
详见 [快速开始 → 流式响应](/01-quickstart#流式响应)
Function Calling 怎么用?+
OpenAI:使用 tools 参数 + tool_choice。
Anthropic:使用 tools 参数,模型返回 tool_use 块。
完整示例:
Prompt 缓存怎么用?+
Anthropic 模型(Claude 全系)支持。在 system / messages 内容块上加 "cache_control": {"type": "ephemeral"}。
缓存命中部分计费显著低于输入价,具体折扣以控制台实时显示为准。
详见 Messages → Prompt 缓存
GPT-5.6 Sol 推理模型怎么用?+
注意:
- 必须用
max_completion_tokens而非max_tokens - 不支持
temperature、top_p - 用
reasoning_effort控制思考强度(low/medium/high) 详见 Chat Completions → 推理模型(GPT-5.6 Sol)
故障与排查
调用报 401 怎么办?+
- 检查
Authorization头 /x-api-key头格式 - 确认 Key 是 OpenAI 协议还是 Anthropic 协议
- 确认 Key 未被禁用
- 重新生成 Key 试试
调用报 429 怎么办?+
- 降低请求并发
- 实现指数退避
- 升级档位(限速更高)
- 联系商务申请提升配额
调用报 500 / 502 / 503 / 504 怎么办?+
🛡️ stable / 🚀 full 通道会自动重试 1 次。 ⚡ fast 通道不会自动重试,建议客户端实现重试。 持续失败请提工单。
调用很慢怎么办?+
- 检查是单次调用慢还是整体慢
- 整体慢:可能命中限速,查看 用量页
- 单次慢:可能上游过载,可换档位重试
- TTFT 慢:用 ⚡ fast 档
合规与安全
我的数据会被用来训练模型吗?+
不会。
- SuperRoute 平台不存储请求与响应的正文内容(提示词、回复)
- 上游模型服务方在 API 模式下不会使用 API 数据训练
平台会存储我的对话内容吗?+
不会。 这是 SuperRoute 的明确立场。
根据《网络安全法》第二十一条,平台必须保留"网络日志"用于安全审计(不少于 6 个月)。 但这不等于要求甚至鼓励明文存储用户的提示词和模型回复内容。 将"网络日志"与"业务数据(对话内容)"混为一谈,反而会增加数据合规风险:
- 数据泄露风险剧增:API 中转站是黑客攻击的高价值目标。明文存储用户对话一旦被拖库,将面临严重的刑事责任和行政处罚
- 隐私协议违约:上游模型服务方的服务条款通常禁止转售方持久化存储用户输入输出
- 监管定性变化:主动存储对话内容可能使平台从"技术通道"变为"内容服务提供者",承担更严格的内容审核和算法备案义务
平台会记录哪些元数据?+
仅为满足"溯源 + 安全审计"要求,平台记录以下元数据(不包含对话正文):
| 字段 | 含义 |
|---|---|
organization_id | 哪个组织/账号 |
api_key_prefix_snapshot | 用哪个 Key(前缀哈希,非明文) |
source_ip_hash | 从哪个 IP 发起(哈希值,非明文) |
requested_model | 调了哪个模型 |
endpoint_path | 调了哪个 API 路径 |
status / http_status / error_code | 是否成功 |
request_started_at | 什么时间 |
prompt_tokens / completion_tokens | Token 消耗数量 |
total_cost | 花费 |
latency_ms | 耗时 |
request_bytes | 请求体大小 |
上述元数据能完整回答"谁、在什么时间、从哪个 IP、调用了哪个模型、是否成功"五个问题,足以配合相关部门进行违法溯源。
请求日志保留多久?+
- 元数据(请求时间、token 数、状态码等):保留 ≥ 6 个月(符合《网络安全法》要求)
- 请求/响应正文内容:完全不存储(无此数据可保留)
💬 还有其他问题?
扫码加入 SuperRoute 开发者 QQ 群(见文档底部),直接问群主或群友。