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.

💡Tip
Error messages are automatically translated based on your language preference. You can switch your language in personal settings, and error messages will update accordingly.

Where to find error codes

  1. Open the Generation History page and find the failed task
  2. Click on the task card to view details — the error code and message are displayed below the task status
  3. In the Canvas Editor, failed nodes also display the corresponding error information

Authentication Errors

Errors related to account authentication and API keys.

Error CodeDescriptionSolution
AUTH_FAILEDAuthentication failedCheck your login status, try logging in again
AUTH_EXPIREDAuthorization credentials expiredRefresh the page or re-login to renew authorization
INVALID_API_KEYInvalid API keyAdmins: 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 CodeDescriptionSolution
QUOTA_EXHAUSTEDProvider quota exhaustedAdmins: recharge or purchase a new plan from the provider dashboard
INSUFFICIENT_CREDITSInsufficient creditsGo to "Top Up Credits" page and recharge, then retry
BALANCE_EXHAUSTEDAccount balance exhaustedGo 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
💡Tip
When a generation task fails due to credit issues, the system automatically refunds any frozen credits — no manual action needed.

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 CodeDescriptionSolution
CONTENT_MODERATIONContent moderation failedModify your prompt and retry
INPUT_MODERATIONInput content failed moderationModify your prompt or replace the reference image
OUTPUT_MODERATIONGenerated content failed moderationTry a different prompt
NSFW_CONTENTInappropriate content detectedModify your prompt to avoid sensitive descriptions
POLICY_VIOLATIONUsage policy violationModify your content to comply with platform policies
SENSITIVE_WORDPrompt contains sensitive wordsRemove or replace words triggering the filter
PROMPT_BLOCKEDPrompt was blockedRewrite your prompt to avoid sensitive content
IMAGE_BLOCKEDReference image was blockedReplace 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
💡Tip
Different AI models and providers have different moderation standards. If one model's moderation is too strict, try switching to another. The Prompt Assistant feature can help optimize your prompts to reduce moderation triggers.

Input Parameter Errors

Errors related to request input and parameter settings.

Error CodeDescriptionSolution
INVALID_PROMPTInvalid promptCheck if the prompt is empty or malformed
PROMPT_TOO_LONGPrompt is too longShorten your prompt and retry
INVALID_IMAGEInvalid image or unsupported formatEnsure image is JPG/PNG/WebP, re-upload
IMAGE_TOO_LARGEImage is too largeCompress the image or reduce resolution before uploading
INVALID_PARAMSInvalid request parametersCheck generation settings (aspect ratio, duration, etc.)
FILE_UNAVAILABLEFile is unavailableRe-upload the file and retry
IMAGE_URL_INVALIDImage URL has expiredRe-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 CodeDescriptionSolution
RATE_LIMITEDToo many requestsWait 1-2 minutes and retry
CONCURRENCY_LIMITEDConcurrent task limit reachedWait 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
💡Tip
In canvas mode, the system automatically manages task queuing and concurrency. If you frequently encounter rate limits, consider reducing the number of parallel nodes in your canvas.

Server Errors

Errors when the server or AI model service encounters issues.

Error CodeDescriptionSolution
SERVICE_UNAVAILABLEService temporarily unavailableRetry later, or switch to another available model
SERVER_ERRORInternal server errorRetry later; if persistent, contact your admin
MODEL_UNAVAILABLEModel temporarily unavailableSwitch 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
💡Tip
For server errors, waiting a few minutes and retrying usually resolves the issue. If the same model keeps failing, consider switching to a different model to continue your work.

Timeout & Network Errors

Errors related to network connectivity and request timeouts.

Error CodeDescriptionSolution
TIMEOUTRequest timed outRetry later; video generation may need longer wait times
NETWORK_ERRORNetwork connection failedCheck 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 CodeDescriptionSolution
TASK_FAILEDTask execution failedVerify input parameters and resubmit
TASK_EXPIREDTask has expiredCreate 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 CodeDescriptionSolution
GENERATION_FAILEDGeneration failedCheck parameters and retry, or switch models
UNKNOWN_ERRORUnknown errorRetry later; if persistent, contact support

General Troubleshooting Steps

If you encounter any of the errors above, follow these steps:

  1. Check the error code — Identify the specific error code from the generation history or canvas node
  2. Follow this guide — Take action according to the corresponding error code instructions above
  3. Wait and retry — Many errors are temporary; waiting 1-2 minutes and retrying usually helps
  4. Switch models — If a specific model keeps failing, try switching to another available model
  5. Check your balance — Ensure you have sufficient credits, top up if necessary
  6. Contact support — If the issue persists, provide the error code and task ID to the support team
💡Tip
In canvases, the system automatically retries certain temporary errors (like network timeouts) without manual intervention. Only permanent errors (like content moderation or insufficient credits) are immediately marked as failed.