Reference
Error codes you may see on Web, Mobile, and Desktop, what they mean, and what to do.
When a request can't be completed, MORATUS shows a localized message backed by one of the codes below. The codes are grouped by type. Most are temporary, and trying again shortly is enough.
Credits and plan
| Code | Meaning | What to do |
|---|---|---|
| INSUFFICIENT_CREDITS | Your credits for this period have run out, or your remaining credits don't cover this step. | Wait for them to renew or upgrade your plan. |
| MODEL_NOT_INCLUDED_IN_PLAN | The selected model or feature is not in your plan. | Switch to Fast or upgrade to Plus/Max. |
| PLAN_CONTEXT_LIMIT_EXCEEDED | The conversation exceeded your plan's context limit. | Start a new or shorter conversation, or upgrade your plan. |
| CREDIT_RESERVATION_FAILED | Credits could not be reserved for the operation. | Try again. |
| MEMBERSHIP_UNAVAILABLE | Membership details were temporarily unreachable. | Try again shortly. |
Files and media
| Code | Meaning | What to do |
|---|---|---|
| PDF_ANALYSIS_UNAVAILABLE | The PDF could not be analyzed. | Check the file and try again. |
| TRANSCRIPTION_TOO_LONG, VIDEO_ANALYSIS_TOO_LONG | The file exceeds your plan's duration limit. | Shorten it or upgrade your plan. |
| TRANSCRIPTION_DAILY_LIMIT | Your daily audio transcription time is used up. | Try again the next day. |
| TRANSCRIPTION_ONE_FILE_ONLY, VIDEO_ANALYSIS_ONE_FILE_ONLY | Only one audio or video file is processed at a time. | Send a single file. |
| *_UNSUPPORTED, *_INVALID | The file format is not supported or the file is corrupted. | Try a different format. |
The * stands for the feature name at the start of the code. For supported file types and sizes, see Attachments.
Generation and demand
| Code | Meaning | What to do |
|---|---|---|
| IMAGE_GENERATION_UNAVAILABLE, VIDEO_GENERATION_UNAVAILABLE, MUSIC_GENERATION_UNAVAILABLE | The generation service is currently unavailable. | Try again shortly. |
| *_BUSY, *_CAPACITY_REACHED | Temporary high demand. | Try again shortly. |
Guest mode
| Code | Meaning | What to do |
|---|---|---|
| GUEST_RATE_LIMITED, GUEST_DAILY_BUDGET_EXHAUSTED | The guest usage limit has been reached. | Create a free account or try again later. |
| GUEST_BUSY | Temporary high demand for guest use. | Try again shortly or create a free account. |
Desktop
| Code | Meaning | What to do |
|---|---|---|
| DESKTOP_AGENT_UNREACHABLE | The app couldn't connect to the agent server. | Check your internet connection; if it continues, contact support with the ref code. |
| PROVIDER_RESPONSE_TIMEOUT | The model sent no data for 3 minutes (3 attempts were made). | Try again shortly. |
| PROVIDER_BUSY | All providers in the chain are busy right now. | Try again shortly. |
| CREDIT_LEDGER_UNAVAILABLE | The credit ledger was temporarily unreachable. | The app retries automatically. |
| CONCURRENCY_LIMIT | More than 2 requests were sent at the same time from the same account. | Wait for the other chat to finish. |
| INVALID_TOOL_CALL | The model's tool call failed validation. | Try again. |
| AGENT_REQUEST_FAILED | Unexpected error. | Contact support with the ref code. |
On Desktop, a reply that ends with an error shows a ref code at the end (for example AGENT_REQUEST_FAILED · ref 47528a0a). The same record is also in %APPDATA%\Moratus\logs\agent-errors.log on your computer. When a step fails on Desktop, the reserved credits are settled against actual usage; if nothing was used, they're refunded (see Error references).
If the error continues
- Follow the suggestion in the table; for temporary errors, wait a few minutes and try again.
- For credit and plan errors, check your remaining credits in the account menu and your plan in Settings > Billing.
- If the error continues, write to support@moratus.ai with the error code, the platform you use, and when and during which task it happened. On Desktop, the ref code is enough.