Error Codes
System error codes reference and troubleshooting guide
Last updated: 2026-02-27
System Error Codes
When using HoldOrange for content generation, you may encounter errors that include an error code and a corresponding error message. You can use these codes to quickly identify the root cause and take appropriate action.
Where to find error codes
- Open the Generation History page and find the failed task
- Click on the task card to view details — the error code and message are displayed below the task status
- In the Canvas Editor, failed nodes also display the corresponding error information
Authentication Errors
Errors related to account authentication and API keys.
| Error Code | Description | Solution |
|---|---|---|
AUTH_FAILED | Authentication failed | Check your login status, try logging in again |
AUTH_EXPIRED | Authorization credentials expired | Refresh the page or re-login to renew authorization |
INVALID_API_KEY | Invalid API key | Admins: verify the provider API key configuration |
Common scenarios:
- Token expired after prolonged inactivity — refreshing the page usually resolves this
- Admin replaced a provider API key with an incorrect one
Quota & Credit Errors
Errors related to account balance and usage limits.
| Error Code | Description | Solution |
|---|---|---|
QUOTA_EXHAUSTED | Provider quota exhausted | Admins: recharge or purchase a new plan from the provider dashboard |
INSUFFICIENT_CREDITS | Insufficient credits | Go to "Top Up Credits" page and recharge, then retry |
BALANCE_EXHAUSTED | Account balance exhausted | Go to "Top Up Credits" page and recharge, then retry |
Common scenarios:
- Selected a high-cost model (e.g., video generation) but didn't have enough credits
- The provider's API quota has been exceeded — contact your admin
Content Moderation Errors
Errors triggered by the content safety moderation system. These indicate that your input or generated content did not pass safety checks.
| Error Code | Description | Solution |
|---|---|---|
CONTENT_MODERATION | Content moderation failed | Modify your prompt and retry |
INPUT_MODERATION | Input content failed moderation | Modify your prompt or replace the reference image |
OUTPUT_MODERATION | Generated content failed moderation | Try a different prompt |
NSFW_CONTENT | Inappropriate content detected | Modify your prompt to avoid sensitive descriptions |
POLICY_VIOLATION | Usage policy violation | Modify your content to comply with platform policies |
SENSITIVE_WORD | Prompt contains sensitive words | Remove or replace words triggering the filter |
PROMPT_BLOCKED | Prompt was blocked | Rewrite your prompt to avoid sensitive content |
IMAGE_BLOCKED | Reference image was blocked | Replace the reference image and retry |
Common scenarios:
- Prompt contains certain sensitive keywords or unusual phrasing that triggered moderation
- Uploaded reference image doesn't meet platform safety standards
- Generated content was flagged as inappropriate by the AI safety system
Input Parameter Errors
Errors related to request input and parameter settings.
| Error Code | Description | Solution |
|---|---|---|
INVALID_PROMPT | Invalid prompt | Check if the prompt is empty or malformed |
PROMPT_TOO_LONG | Prompt is too long | Shorten your prompt and retry |
INVALID_IMAGE | Invalid image or unsupported format | Ensure image is JPG/PNG/WebP, re-upload |
IMAGE_TOO_LARGE | Image is too large | Compress the image or reduce resolution before uploading |
INVALID_PARAMS | Invalid request parameters | Check generation settings (aspect ratio, duration, etc.) |
FILE_UNAVAILABLE | File is unavailable | Re-upload the file and retry |
IMAGE_URL_INVALID | Image URL has expired | Re-upload the image instead of pasting an external link |
Common scenarios:
- Uploaded an unsupported image format (e.g., BMP, TIFF)
- Image exceeds the model's size limit (typically 10MB)
- Referenced external image link has expired or is inaccessible
Rate Limit Errors
Errors triggered when requests are too frequent.
| Error Code | Description | Solution |
|---|---|---|
RATE_LIMITED | Too many requests | Wait 1-2 minutes and retry |
CONCURRENCY_LIMITED | Concurrent task limit reached | Wait for current tasks to finish before submitting new ones |
Common scenarios:
- Submitted multiple generation tasks in quick succession
- Canvas with too many parallel nodes running simultaneously
Server Errors
Errors when the server or AI model service encounters issues.
| Error Code | Description | Solution |
|---|---|---|
SERVICE_UNAVAILABLE | Service temporarily unavailable | Retry later, or switch to another available model |
SERVER_ERROR | Internal server error | Retry later; if persistent, contact your admin |
MODEL_UNAVAILABLE | Model temporarily unavailable | Switch to another model |
Common scenarios:
- AI provider is undergoing maintenance or upgrades
- Server load is temporarily too high
- A specific model has been temporarily disabled or taken offline
Timeout & Network Errors
Errors related to network connectivity and request timeouts.
| Error Code | Description | Solution |
|---|---|---|
TIMEOUT | Request timed out | Retry later; video generation may need longer wait times |
NETWORK_ERROR | Network connection failed | Check your internet connection |
Common scenarios:
- Unstable network caused a connection interruption with the AI service
- HD video generation exceeded the default timeout duration
- Proxy server or VPN affecting network connectivity
Task Errors
Errors related to async task execution status.
| Error Code | Description | Solution |
|---|---|---|
TASK_FAILED | Task execution failed | Verify input parameters and resubmit |
TASK_EXPIRED | Task has expired | Create a new generation task |
Common scenarios:
- Task waited too long in queue and expired
- AI model encountered an internal error during processing
General Errors
Other errors that don't fall into specific categories.
| Error Code | Description | Solution |
|---|---|---|
GENERATION_FAILED | Generation failed | Check parameters and retry, or switch models |
UNKNOWN_ERROR | Unknown error | Retry later; if persistent, contact support |
General Troubleshooting Steps
If you encounter any of the errors above, follow these steps:
- Check the error code — Identify the specific error code from the generation history or canvas node
- Follow this guide — Take action according to the corresponding error code instructions above
- Wait and retry — Many errors are temporary; waiting 1-2 minutes and retrying usually helps
- Switch models — If a specific model keeps failing, try switching to another available model
- Check your balance — Ensure you have sufficient credits, top up if necessary
- Contact support — If the issue persists, provide the error code and task ID to the support team