1. Preparation
PixVerse Platform Docs
  • Get Started
    • Billing and Usage
    • Quick Start
    • Contact Us
    • Privacy and Data Protection
    • Model Capability Map
    • What Is PixVerse AI?
  • API
    • Preparation
      • Start Here
      • Concurrency Rules
      • Query Task Status
      • Error Codes
      • Error Details
      • FAQ
      • Webhook Callbacks
      • Upload Image
        POST
      • Upload Media (Video and Audio)
        POST
      • Verify Uploaded Audio
        POST
      • Get Effect Template List
        GET
      • Get TTS Speaker List
        GET
      • Get Restyle Effect List
        GET
      • Query Task Status
        GET
      • Get Account Balance
        GET
      • Usage Deduction Query
        POST
      • Create Custom Voice
        POST
      • Delete Custom Voice
        DELETE
    • Core Capabilities
      • Text-to-Video
      • Image-to-Video and Video Templates
      • First and Last Frame Video
      • Reference-to-Video (Fusion)
      • Multi-Transition Video
      • Video Extend
      • Video Expand
      • Image Template Generation
      • Get Image Generation Result
    • Solutions
      • Video Upscale
      • Video Restyle
      • Lipsync
      • Image Avatar
      • Select Video Mask
      • Sound Effect
      • Subject Replacement (Swap)
      • Motion Control (Mimic)
      • One-click Real Estate Video
      • One-click VibeMV
  • Pricing
    • PixVerse API Pricing
  • Changelog
    • Changelog
  1. Preparation

Error Codes

ErrCode is the numeric business error code in the response body, separate from the HTTP status. 0 means the request succeeded; for a non-zero value, look up the code below. Do not rely on the HTTP status alone to determine success.
An error response with optional details can look like this:
{
  "ErrCode": 400017,
  "ErrMsg": "Required field prompt are missing or empty.",
  "Resp": null,
  "Error": {
    "Type": "FIELD_REQUIRED",
    "Message": "Required field 'prompt' is missing or empty. Provide a value for this field.",
    "Param": {
      "Fields": [
        "prompt"
      ]
    }
  }
}
ErrMsg gives a brief error description; Error.Message gives the specific cause and suggested change.
Error.Type, Error.Message, and Error.Param are optional supplementary error details. Existing clients can continue handling errors by ErrCode; see Error Details for more specific classifications and causes.
For task execution states and status queries after task creation, see Query Task Status
Table descriptions are ErrMsg examples or summaries and may differ from actual responses. Branch on the numeric ErrCode, not ErrMsg text.

Error code index#

The table covers API calls, account operations, and platform management. Some codes have different meanings across operations; use the returned message and endpoint reference for troubleshooting.
ErrCodeDescription
400Required account fields are missing.
500Request processing failed; the cause depends on the operation.
10001Invalid authentication token.
10002Authentication token expired.
10003Sign-in is required.
10004API key is missing.
10005API key is unregistered, or the account was signed in elsewhere.
10011Invalid platform value.
99999Unknown error
400002Required business contact fields are missing.
400009Token is missing.
400011Empty parameter
400012Invalid account
400013Invalid binding request: incorrect parameter type or value
400017Invalid parameter
400018, 400019Prompt or negative prompt is too long
400032Invalid image ID
499001The client closed the request.
500008Requested data not found
500010A request to an upstream service failed.
500012Verification expired or was already used.
500020User does not have permission for this operation
500030Image size cannot exceed 20 MB, 10,000 px
500031Failed to retrieve image information
500032Invalid image format
500033Invalid image width or height
500041Image upload failed
500042Invalid image path
500044Reached the limit for concurrent generations
500047The provided media is invalid. The type may be incorrect, or the resource is no longer available.
500052The image failed content moderation. Please change it and try again.
500054Content moderation failure. The image may contain inappropriate content.
500058The model is not supported.
500060Monthly effects activation limit reached
500061Video extension exceeds the supported duration.
500063An input failed content moderation.
500064Content has been deleted
500069The system is experiencing high load
500070The current template is not activated
500071This effect does not support 720p or 1080p
500081The effect does not exist.
500085You can only query content generated by your account.
500090Insufficient balance. Unable to generate video.
500100Internal error
500111The video could not be downloaded.
500112The audio could not be downloaded.
500113The speaker ID is invalid or unsupported.
500170The template is not activated.
500200The user does not exist.
500201Incorrect password.
500203Invalid verification code.
500204The verification code has expired.
500205The username is already taken.
500206OAuth sign-in is required to set an initial password.
500207The email address is already registered.
500208The email address is registered through an external sign-in provider.
500209No account was found for this email address.
500210Required account fields are missing.
500213The password exceeds an allowed limit.
500217New registrations do not accept + in email addresses.
500307Token validation failed.
500311The email address is already in use.
500313A network connection could not be established.
500551The product URL could not be fetched.
500801The API key name is already in use.
701001Subject detection failed.
701002Upload a photo with a clear subject such as a person or an animal.
701003Ensure your reference video includes a person as the primary focus.
701007A network error occurred.
701009You can only query content generated or uploaded by your account.
701020The audio has not been verified.
701024Invalid lip_sync_tts_speed.
701025subtitle must be a boolean.
702002The webhook URL is already in use.
702003The API webhook does not exist.
712008Request too fast. Please try again later.
4000012A numeric value could not be parsed as an unsigned integer.
For detailed checks, see Error Details.
Previous
Query Task Status
Next
Error Details