> ## Documentation Index
> Fetch the complete documentation index at: https://docs.token.poryf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 错误排查

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

## 排查顺序

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

## 常见状态

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

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

## 重试

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

## 反馈问题

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