HTTP 状态码
宁享Token API 使用标准 HTTP 状态码标识请求结果。
状态码总览
| 状态码 | 含义 | 是否可重试 |
|---|---|---|
| 200 | 成功 | — |
| 201 | 创建成功 | — |
| 400 | 请求错误 | ❌ |
| 401 | 未授权 | ❌ |
| 403 | 禁止访问 | ❌ |
| 404 | 资源不存在 | ❌ |
| 429 | 请求过多 | ✅ |
| 500 | 服务端错误 | ✅ |
| 503 | 服务不可用 | ✅ |
| 504 | 请求超时 | ✅ |
2xx 成功
200 OK
请求成功，响应体包含结果数据。绝大多数 API 调用返回此状态码。
201 Created
资源创建成功。用于 POST /api/assets（创建素材）、POST /v1/video/generations（创建视频任务）等创建类接口。
4xx 客户端错误
400 Bad Request
请求参数错误。常见原因：
- 请求体 JSON 格式错误
- 缺少必填字段
- 字段值不合法（如
temperature超出 0~2） - 模型不支持请求的参数组合
排查：检查 error.message 和 error.param，修正请求参数。
401 Unauthorized
鉴权失败。常见原因：
- 未提供
Authorization头 - API Key 无效或已过期
- API Key 已被吊销
排查：确认 Authorization: Bearer <YOUR_API_KEY> 格式正确，Key 来自 宁享Token 控制台。
403 Forbidden
权限不足。常见原因：
- API Key 已禁用
- IP 不在白名单
- 无权使用该模型
- 账户欠费
排查：检查账户状态和模型权限设置。
404 Not Found
资源不存在。常见原因：
- URL 路径错误
- 模型 ID 不存在
- 素材 ID / 任务 ID 不存在
排查：确认 URL 和资源 ID 正确。
429 Too Many Requests
触发速率限制。常见原因：
- 每分钟请求数（RPM）超限
- 每分钟 Token 数（TPM）超限
- 并发数超限
- 余额不足
排查：降低请求频率，检查余额。详见 速率限制。
5xx 服务端错误
500 Internal Server Error
服务端内部错误。建议重试，持续失败请联系客服并提供 request_id。
503 Service Unavailable
服务暂时不可用。常见原因：
- 模型过载
- 维护中
- 下游供应商异常
建议：等待后重试，或切换其他模型。
504 Gateway Timeout
请求超时。常见原因：
- 请求处理时间过长
- 下游模型响应慢
建议：减少 max_tokens、缩短 prompt，或重试。
响应头
| 响应头 | 说明 |
|---|---|
X-Request-Id | 请求唯一 ID，联系客服时提供 |
Retry-After | 429 / 503 时返回，建议等待秒数 |
X-RateLimit-Limit-Requests | 当前 RPM 上限（未配置该维度时不返回） |
X-RateLimit-Remaining-Requests | 剩余请求数 |
X-RateLimit-Reset-Requests | 距限额重置的秒数 |
X-RateLimit-Limit-Tokens | 当前 TPM 上限（未配置该维度时不返回） |
X-RateLimit-Remaining-Tokens | 剩余 Token 数 |