错误参考表
| 症状 | 建议的修复方法 |
|---|---|
| 401 Unauthorized | 确认 API 密钥有效，包含 mr_live_ 前缀，且未被撤销。 |
| 403 Forbidden | 密钥属于另一个项目或处于非活动状态。为此集成签发新密钥。 |
| 供应商凭据未配置 | 在当前项目的 Settings → Providers 下添加供应商 API 密钥。 |
| 结构化输出解析错误 | 验证您的 JSON 架构 (schema)，降低复杂度，或尝试能力更强的模型。查看原始日志条目以了解供应商响应。 |
| 超时 / 响应缓慢 | 配置工作流故障转移，以便 ModelRiver 可以尝试备用供应商。监控 可观测性 (Observability) 了解延迟模式。 |
| 非预期的缓存数据 | 确保缓存字段与有效负载结构匹配。数组索引从 0 开始（例如：messages.0.content）。 |
| 未收到网络钩子 (Webhook) | 验证端点 URL 正确且返回 2xx。查看 投递与重试 了解重试状态。 |
| 网络钩子 (Webhook) 签名不匹配 | 确保密钥 (secret) 完全匹配（无额外空格）。验证您是否使用原始请求正文进行签名计算。 |
| 超出速率限制 | ModelRiver 执行全平台范围的速率限制。如果您需要更高的吞吐量，请联系支持。 |
| AI 响应为空 | 检查供应商是否具有足够的上下文。验证 messages 数组格式和模型可用性。 |
身份验证快速修复
API 密钥问题
Bash
# 验证您的密钥格式echo $MODELRIVER_API_KEY# 应以 mr_live_ 开头 # 使用 curl 测试curl -H "Authorization: Bearer $MODELRIVER_API_KEY" \ https://api.modelriver.com/v1/ai \ -d '{"workflow": "test", "messages": [{"role": "user", "content": "hello"}]}'供应商凭据问题
- 导航至 Settings → Providers
- 验证该供应商是否显示绿色对勾
- 如果没有，请重新输入凭据并保存
- 在游乐场 (Playground) 中使用简单的请求进行测试