HTTP Status Code Reference

HTTP status code reference for the AnyRouter API: 503, 429, 403, 401 and 400 errors with messages and causes, to debug rate limits, quota and auth issues.

Key error-code mapping table

A 400 status usually indicates a parameter error — check the API reference. Most 400 errors are passed through from the upstream provider.
The response ID in error responses has been changed to tid (traceId), used for error tracking and troubleshooting.

HTTP Status Code	Error Identifier	Error Message	Common Cause	English Error Message
503	-	Incorrect model name — check the model marketplace, or the current group has no permission to use this model	No available channel to handle the request	Incorrect model ID. Please request to view the model page or you do not have permission to use this model
503	-	The model is rate-limited by the official provider — contact support to increase concurrency, or try again later	Model rate-limited by the official provider	Rate limited by provider – contact support to request higher concurrency or try again later.
429	-	Request rate exceeds the limit	Request rate exceeds the limit	The xx (xx: model id) model Too many requests; please try again later.
403	insufficient_user_quota	Insufficient account balance — a top-up is required	Insufficient account balance; top-up required	Your account balance is insufficient. Please recharge your account to continue using the API.
403	-	The user has been banned	User status disabled or blacklisted	Account suspended.
403	-	Operation not allowed — insufficient permissions	User role lacks sufficient permissions	Forbidden – insufficient permissions.
403	-	This API key can only be used from the specified IP ranges	The IP is outside the key's allowed ranges	Forbidden – key (last six characters of the requested key) allowed only from approved IP ranges.
403	-	This API key is not authorized to use the model	The key does not support the requested model	Forbidden – key (last six characters of the requested key) not authorized to access the requested model.
403	-	Regular users cannot specify a channel	A non-admin user attempted to specify a channel	Key error; (last six characters of the requested key)
403	-	The channel has been disabled	Channel status is disabled	Forbidden – channel has been disabled.
401	-	Operation not allowed — not logged in and no access token provided	No Authorization header provided	Unauthorized – no access token supplied; please log in and include a valid token.
401	-	Operation not allowed — invalid access token	Access-token validation failed	Unauthorized – access token is invalid or expired.
400	-	Invalid channel Id	Channel ID malformed or does not exist	Bad Request – invalid channel ID.
400	prompt_missing	prompt is required	Image generation request is missing a prompt	prompt is required
400	prompt_too_long	prompt is too long	Prompt exceeds the length limit	prompt is too long
400	text_too_long	input is too long	Audio input text is too long	input is too long
400	size_not_supported	size not supported	Image size not supported by the model	size not supported
400	n_not_within_range	invalid value of n	The n parameter is out of the valid range	invalid value of n