使用指南
报错与排查
排查 RouteMarket 的认证、网络、参数、额度与上游错误。
排错时先保存状态码、请求时间、请求 ID 和所用模型。不要在日志或工单中暴露完整 API Key。
常见状态码
| 状态码 | 常见原因 | 建议操作 |
|---|---|---|
400 | 请求 JSON、字段类型或模型参数不正确 | 用最小请求重试，并逐项加回可选参数 |
401 | 密钥缺失、格式错误、失效或复制不完整 | 检查 Bearer 前缀并重新创建密钥 |
403 | 项目、模型或路由没有权限 | 检查项目策略、模型授权和账户状态 |
404 | Base URL、接口路径或模型名错误 | 核对 /v1、端点路径和模型列表 |
413 | 请求体、图片或附件过大 | 压缩素材或减少输入内容 |
429 | 频率、并发或额度达到限制 | 降低并发并采用指数退避 |
500 / 502 / 503 | 网关或上游暂时不可用 | 稍后重试，并保留请求 ID |
504 | 上游处理超时 | 缩短任务、增加客户端超时或改用异步接口 |
最小化请求
curl https://api.routemarket.ai/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $ROUTEMARKET_API_KEY" \
-d '{"model":"your-model-name","messages":[{"role":"user","content":"ping"}]}'如果最小请求成功，问题通常来自额外参数、附件、客户端代理设置或模型特有能力。
联系支持时提供
- 请求时间和时区
- HTTP 状态码与错误代码
- 请求 ID 或任务 ID
- 使用的端点和模型名
- 已脱敏的最小复现请求