Routic

常见问题排查

本指南帮你解决使用 Routic 时的常见问题。如果遇到这里没覆盖的错误，联系支持并带上你的 request_id。

API Key 问题

密钥创建失败

现象：在控制台创建新 API Key 时，提示"暂时无法创建密钥，请稍后重试"。

原因：网关服务暂时不可用或负载较高。

解决：

  1. 等几分钟后重试
  2. 如果超过 10 分钟问题仍存在，联系支持
  3. 检查账户余额——余额过低时密钥可能创建失败

密钥不存在

现象：调用 API 时提示"未找到该 API 密钥"。

原因：密钥已被吊销、过期或从未存在。

解决：

  1. 检查密钥格式：必须以 sk- 开头，长度 48 字符
  2. 在控制台确认密钥是否存在
  3. 如果密钥被吊销，创建新密钥
  4. 确保使用正确的 Base URL：https://api.routic.ai/v1

认证错误

API 调用返回 401 认证错误时，详见 HTTP 语义与错误载荷。

服务可用性问题

服务暂时不可用

现象：控制台或 API 返回"服务暂时不可用，请稍后再试"。

原因：网关或后端服务正在经历问题。

解决：

  1. 等待 30 秒到 1 分钟后重试
  2. 检查状态页了解是否有已知故障
  3. 如果是 API 调用，使用指数退避（见错误处理与重试)
  4. 问题持续超过 10 分钟时联系支持

模型调用错误

401 认证失败

API Key 无效、过期或缺失。

检查项操作
密钥格式必须以 sk- 开头，48 字符
密钥状态在控制台确认密钥是否被吊销
请求头添加 Authorization: Bearer sk-xxx

详见 HTTP 语义与错误载荷。

404 资源不存在

请求的资源或模型不存在。

检查项操作
模型名在模型目录确认模型存在
接口 URL使用 /v1/chat/completions，不是其他路径
Base URL确保是 https://api.routic.ai/v1

429 速率限制

超出速率限制（每分钟请求数或每分钟 token 数）。

检查项操作
RPM/TPM 限制默认：每密钥 100 RPM、10,000 TPM
Retry-After 头等待响应头指定的秒数
多密钥轮换在多个密钥间轮换（每个密钥独立限速）

不要立即重试——使用指数退避。详见 错误处理与重试。

500 / 503 服务器错误

临时服务器端问题。

状态码含义操作
500服务器内部错误使用指数退避重试
503上游服务不可用等待 30 秒后重试

重试策略见 错误处理与重试。

控制台问题

控制台默认显示中文

现象：你希望看英文界面，但控制台显示中文。

解决：点击右上角的语言切换按钮，切换到英文。

支付后余额仍为零

现象：完成支付后余额仍显示为零。

原因：支付处理延迟（Stripe 通常需要 1–5 分钟）。

解决：

  1. 等待 5 分钟后刷新
  2. 查收邮件确认支付成功
  3. 如果 10 分钟后余额仍为零，带上支付凭证联系支持

何时联系支持

遇到以下情况请联系支持：

  • 错误持续超过 10 分钟，重试无效
  • 支付成功但余额未更新
  • 怀疑账户或密钥被泄露
  • 需要文档中未覆盖的功能

务必带上：

  • 你的账户邮箱
  • 错误响应中的 request_id
  • 错误发生的大致时间
  • 相关截图（如有）

联系方式见 SLA 与支持渠道。

相关文档