错误排查

按错误信息定位问题，避免盲目重复请求。

​

排查顺序

1. 检查完整地址是否重复包含 /v1。
2. 确认使用的是未来模力 API 密钥，而非登录密码或厂商密钥。
3. 从模型列表复制精确的模型 ID。
4. 检查余额、密钥额度、有效期与模型权限。
5. 使用最小文本请求复现，再逐步添加高级参数。

​

常见状态

状态码只提供线索，应结合响应中的 error.message 与错误类型判断；平台和上游的状态码可能不同。

状态	常见检查方向
400	请求 JSON、必填字段、模型支持的参数
401	密钥是否正确，Bearer 请求头是否完整
403	权限、密钥限制或访问策略
404	Base URL、接口路径和模型 ID
429	错误正文中的限流、额度或容量提示
5xx	网关或上游临时异常，记录请求信息后排查

​

重试

参数或密钥错误应先修正。限流时遵循响应中的重试提示（若有），降低并发并逐步延长间隔。设置重试上限；重发请求可能产生额外用量。

​

反馈问题

请提供发生时间、模型 ID、接口路径、脱敏后的错误正文，以及请求 ID（若有）。不要发送完整密钥、Authorization 请求头或包含个人信息的对话内容。