Troubleshooting Reference
Error codes
Common errors are grouped into categories such as authentication, parameters, quotas, and service exceptions, making it easier to quickly determine whether the issue is on the client side or the server side.
| 渠道 | 地址 |
|---|---|
| Authentication | /docs/support/authentication |
| Online debugging | /docs/support/debug |
Authentication
- - 401: Key is invalid, missing, or has expired.
- - 403: The Key is valid, but does not have permission to access the current resource.
- - First, check whether the request headers and authentication method are correct.
Parameter classes
- - 400: The request parameters are incomplete or improperly formatted.
- - 422: The field value is valid, but it does not satisfy business constraints.
- - Prioritize verifying model names, dimensions, durations, and enum values.
Quotas and Resources
- - 429: Insufficient quota, rate limit exceeded, or concurrency too high.
- - 404: The path or resource ID does not exist.
- - First confirm whether the API path being called matches the documentation.
Service exception class
- - 500: Internal server error.
- - 502 / 503: The upstream service is unstable or temporarily unavailable.
- - We recommend checking the status page first, then trying again.
说明
- - If the same error keeps occurring, we recommend collecting the complete request and response and submitting them through the support channel.
- - The error code page works well when used together with the FAQ, making centralized troubleshooting easier.