📊 HTTP 状态码说明
SUTUI API 使用标准 HTTP 状态码来表示请求的成功或失败状态。
| 状态码 | 含义 | 说明 |
|---|---|---|
| 200 | 成功 | 请求成功处理，返回期望的数据 |
| 400 | 请求错误 | 请求参数错误或余额不足 |
| 401 | 未授权 | Token 无效或未提供身份验证信息 |
| 404 | 资源不存在 | 请求的资源（如任务）不存在 |
| 500 | 服务器内部错误 | 服务器处理请求时发生错误 |
| 503 | 服务不可用 | 服务暂时不可用（如：没有可用的 API 账号） |
🔄 任务状态说明
任务在执行过程中会经历不同的状态，以下是各状态的详细说明。
🕰️ pending
待处理
任务已创建但尚未开始执行，正在等待系统分配资源。
⚡ running
运行中
任务正在执行中，正在生成或处理结果。请耐心等待。
✅ completed
已完成
任务成功完成，结果已生成并可以通过 output_params 获取。
❌ failed
失败
任务执行失败，可能是由于参数错误或系统错误导致。
🔄 状态流转
任务状态的正常流转顺序：
pending → running → completed
如果任务执行失败，状态会从 running 直接转为 failed。
📝 错误代码及解决方案
常见错误及处理方法
401 错误 - 未授权
{
"code": 401,
"message": "Token invalid, please check out"
}
解决方案：
- 检查 Authorization 头中的 Bearer token 是否正确
- 确认 token 是否已过期，如有需要请重新获取
- 检查请求头格式是否正确：
Authorization: Bearer YOUR_TOKEN
400 错误 - 请求参数错误
{
"code": 400,
"message": "余额不足"
}
解决方案：
- 检查账户余额是否足够
- 验证请求参数是否符合接口要求
- 检查 JSON 格式是否正确
404 错误 - 资源不存在
{
"code": 404,
"message": "任务不存在"
}
解决方案：
- 确认任务 ID 是否正确
- 检查任务是否属于当前用户
- 确认任务是否已被删除
500 错误 - 服务器内部错误
{
"code": 500,
"message": "提交任务到Fal API失败: error details"
}
解决方案：
- 稍后重试请求
- 检查请求参数是否合理
- 如问题持续，请联系技术支持