Errors and troubleshooting

Check the HTTP status, error message, and request ID. Redact tokens, signatures, private media URLs, and personal data from logs and support requests.

Status	Check first
400	JSON syntax, required fields, enum values, media URLs, and task IDs
401	Valid Max Router token and correct authentication headers
403	Token model restrictions, group, and account permissions
404	Endpoint path, task ID, and task ownership
429	Rate, concurrency, or quota limits; follow response guidance and retry with backoff
5xx	Transient service errors; retain the request ID, retry later, or contact an administrator

Responses may also include model- or channel-specific errors. If the client times out after submitting a generation task, first check whether a task was created to avoid duplicate submissions and charges.

Common questions

Model not found or no available channel: call GET /v1/models and check the model name, group, and token permissions.

Callback not received: check the public HTTPS URL, receiver status, and gateway, and query the task.

Image or video cannot be read: confirm the URL is accessible to the server, has not expired, and meets the model requirements.

Browser debugging cannot reach the API: check the network connection, the base URL https://maxrouterai.com, and the current service status.

Errors and troubleshooting

Common questions#

Common questions