Skip to content

🚫 Hailuo Quota Exceeded (HailuoQuotaExceeded)

Cause

  • The number of characters required for this request exceeds your remaining monthly Hailuo quota.
  • You have used all your Hailuo usage included in your Patreon tier or the Free plan.
  • Very long text in a single request may also trigger the quota limit quickly.

How to Fix

  1. Wait for the Monthly Reset

    • Hailuo usage resets automatically on the 1st of every month.
    • After the reset, requests will be processed normally again.

  2. Upgrade Your Patreon Tier

    • If you need more Hailuo usage, consider upgrading your Patreon membership.

    🔗 Patreon Membership
    https://www.patreon.com/VoiceScriptPlayer/membership

  3. Subscribe to Hailuo Directly

    • Instead of using the Voice Script Server API, you can directly subscribe to the Hailuo API for larger or unlimited usage.
    • Recommended for heavy usage or professional work.

    🔗 Direct Hailuo Subscription Guide
    https://voicescriptplayer.github.io/vsp-docs/ko/ai/hailuo-subscription/

  4. Check Your Voice Script Server API Settings

    • Make sure your API key is correctly entered in the program settings.
    • If the API key is invalid or disabled, usage retrieval may fail and cause quota errors.

💡 Network Connection Error (NetworkConnectionError)

Cause

  • Your internet connection is unstable or disconnected.
  • A firewall, VPN, or Proxy is blocking access to the Hailuo server.
  • The Hailuo server may be temporarily unreachable.

How to Fix

  1. Check Your Internet Connection

    • Ensure Wi-Fi or wired network is functioning normally.

  2. Check Firewall or VPN

    • Make sure https://api.minimax.io is not being blocked.
    • Disable VPN or Proxy and try again.

  3. Try Again Later

    • This may be a temporary server issue. Retry after a few minutes.

💡 Authentication Error (HailuoAuthError)

Cause

  • The Hailuo API key is incorrect or expired.
  • The Authorization header is in an invalid format or missing.

How to Fix

  1. Verify Your API Key

    • Copy the key exactly from your Hailuo dashboard.

  2. Regenerate the Key

    • If the key has expired or been deleted, generate a new one.

  3. Using Voice Script Server

    • Ensure the Patreon-linked API key is active and correctly applied.

💡 Request Timeout (HailuoTimeoutError)

Cause

  • The Hailuo server did not respond within the time limit.
  • Server load may be temporarily high.

How to Fix

  1. Try Again Later
  2. Check Network Stability
  3. Shorten the Input Text

💡 Request Rate Limit (HailuoRateLimitError)

Cause

  • Too many requests were sent in a short period of time.

How to Fix

  1. Wait 1–2 Minutes

    • Rate limits automatically reset.

  2. Increase Delay Between Requests

    • Wait at least 1 second between each request.

💡 TPM (Token Per Minute) Exceeded (HailuoTPMError)

Cause

  • The number of characters processed per minute exceeded the allowed limit.

How to Fix

  1. Split Text Into Smaller Chunks
  2. Increase the Delay Between Requests

💡 Unsupported Characters Detected (HailuoIllegalCharacterError)

Cause

  • The text contains emojis or symbols that Hailuo cannot process.

How to Fix

  1. Remove Emojis and Special Characters

    • Examples: 💕 ✨ 🔥 ❌

  2. Simplify the Text

💡 Invalid Input Format (HailuoInvalidInputFormat)

Cause

  • Required voice settings or audio settings are missing or invalid.
  • The text or settings were not recognized properly.

How to Fix

  1. Reset Voice Settings
  2. Simplify the Text
  3. Use the Latest Version of VoiceScriptPlayer

💡 Insufficient Credits (HailuoCreditError)

Cause

  • Your Hailuo account has insufficient balance or free usage has expired.

How to Fix

  1. Check Your Hailuo Account Balance
  2. Recharge and Try Again
  3. Consider a Paid Plan for Heavy Usage

💡 Bad Request (HailuoRequestError)

Cause

  • Some text or voice settings contain invalid values or are out of range.

How to Fix

  1. Simplify the Text
  2. Reset Voice Settings
  3. Try With a Shorter Sentence

💡 Server Error (HailuoServerError)

Cause

  • Internal Hailuo server issue
  • Temporary outage or maintenance

How to Fix

  1. Try Again Later
  2. Check Official Notices or Community Channels
  3. Try With a Different Voice

💡 Response Parsing Error (HailuoParseError)

Cause

  • The server returned an unexpected response.

How to Fix

  1. Try Again
  2. Reduce Text Length
  3. Use the Latest Program Version

💡 Empty Audio Output (HailuoEmptyAudio)

Cause

  • Extremely short text may generate no audio.
  • Certain voices may fail to produce audio depending on the content.

How to Fix

  1. Use a Longer Sentence
  2. Try a Different Voice
  3. Retry

💡 Invalid Audio Format (HailuoInvalidAudioFormat)

Cause

  • The server returned corrupted or invalid audio data.

How to Fix

  1. Try Again
  2. Test With a Shorter Text
  3. Check for Program Updates

💡 Audio Processing Error (HailuoAudioProcessingError)

Cause

  • The audio data could not be decoded properly.

How to Fix

  1. Retry
  2. Use a Different Text
  3. Try With Different Voice Settings

💡 Insufficient Balance (HailuoInsufficientBalanceError)

Cause

  • Your Hailuo account has insufficient credit or balance to process the request.

Solution

  1. Check Account Balance
    • Please check your remaining balance on the Hailuo dashboard.
  2. Recharge Account
    • You need to recharge your account to continue using the service.

💡 Internal Server Error (HailuoInternalError)

Cause

  • An unexpected error occurred within the Hailuo server.

Solution

  1. Retry Later
    • It is likely a temporary issue. Please wait a moment and try again.
  2. Check Status
    • If the issue persists, please check the service announcements.

💡 Sensitive Input Detected (HailuoSensitiveInputError)

Cause

  • The input text prompt contains sensitive content (politics, violence, adult content, etc.) prohibited by policy.

Solution

  1. Modify Prompt
    • Please review your input and remove or rephrase any sensitive words or expressions.

💡 Sensitive Output Detected (HailuoSensitiveOutputError)

Cause

  • The generated result was flagged as sensitive content, and the output was blocked.

Solution

  1. Adjust Input
    • Please modify your input prompt to guide the generation toward a different result.

💡 System Error (HailuoSystemError)

Cause

  • The request failed due to an issue with the database or system components.

Solution

  1. Retry
    • This may be a temporary issue due to server load. Please try again later.

💡 Connection Limit Reached (HailuoConnectionLimitError)

Cause

  • The server refused processing because there were too many concurrent connection requests.

Solution

  1. Adjust Request Frequency
    • Reduce the number of concurrent requests or wait briefly before requesting again.
  2. Contact Support
    • If the issue persists, you may need to contact Hailuo support.

💡 ASR Similarity Check Failed (HailuoASRCheckError)

Cause

  • The voice in the provided audio file does not match the input text validation content.

Solution

  1. Check File and Text
    • Ensure that the uploaded audio (file_id) and the validation text (text_validation) match exactly.

💡 Clone Prompt Error (HailuoClonePromptError)

Cause

  • There is an issue with the prompt audio or text used for Voice Cloning.

Solution

  1. Check Audio Quality
    • Ensure the prompt audio is clear and free of background noise.
  2. Verify Prompt Text
    • Make sure the audio content matches the prompt text exactly.

💡 Invalid Parameters (HailuoInvalidParamsError)

Cause

  • The configuration values or JSON structure included in the API request are incorrect.

Solution

  1. Review Request Parameters
    • Check if the field names and value formats in your data match the API specifications.

💡 Invalid Voice ID (HailuoInvalidVoiceIDError)

Cause

  • The requested Voice ID does not exist or has an incorrect format.
  • It refers to an unusable sample.

Solution

  1. Verify ID
    • Please double-check the list to ensure the model or Voice ID you are trying to use is correct.

💡 Duration Error (HailuoDurationError)

Cause

  • The length of the uploaded voice file is either too short or too long.

Solution

  1. Adjust File Length
    • Edit the audio to a suitable length for voice cloning (check recommended duration) and try again.

💡 Duplicate Voice ID (HailuoDuplicateVoiceIDError)

Cause

  • The Voice ID you are trying to create already exists in the system.

Solution

  1. Change ID
    • Please try creating it with a different Voice ID.

💡 Access Denied (HailuoAccessDeniedError)

Cause

  • You do not have permission to use this Voice ID. (You are not the creator, or it hasn't been shared with you.)

Solution

  1. Check Ownership
    • Verify if it is a voice you created or a publicly available voice.

💡 Rate Growth Limit (HailuoRateGrowthError)

Cause

  • The request volume increased too rapidly within a short period, and it was blocked for system protection.

Solution

  1. Control Request Speed
    • Avoid sudden spikes in requests and gradually increase the request frequency.

💡 Prompt Audio Too Long (HailuoPromptAudioTooLongError)

Cause

  • The prompt audio used for voice cloning exceeds the allowed length.

Solution

  1. Trim Audio
    • Please edit the prompt audio file to be less than 8 seconds and re-upload.

💡 Invalid API Key (HailuoInvalidApiKeyError)

Cause

  • The API Key format is incorrect, or the key is inactive.

Solution

  1. Recheck API Key
    • Verify the key is correct, and generate a new one if it has expired.

💡 Usage Limit Exceeded (HailuoUsageLimitExceededError)

Cause

  • You have exhausted the allowed API calls or usage quota for the current period (hour/day/month).

Solution

  1. Wait for Resource Renewal
    • Please wait until the next renewal cycle (typically a 5-hour window).

hailuo-unexpected

💡 Unexpected Response (HailuoUnexpectedResponse)

Cause

  • Required fields are missing or the server returned an irregular structure.

How to Fix

  1. Try Again Later
  2. Reduce Text Length
  3. Update VoiceScriptPlayer to the Latest Version

hailuo-unknown

💡 Unknown Error (HailuoUnknownError)

Cause

  • An unexpected problem occurred.

How to Fix

  1. Restart the Program
  2. Reset Settings and Retry
  3. Contact the Developer if the Issue Persists