PixVerse Platform Docs
  1. Trouble Shooting
PixVerse Platform Docs
  • Learn about PixVerse Platform
    • Introduce to PixVerse Platform
    • Quick Start
  • Getting started
    • How does the API work?
    • How to get API key?
    • How to check account balance?
    • How to subscribe API plans?
    • How to use Text-to-video
    • How to use Image-to-video
    • How to use Effects?
    • How to use Transition(First-last frame Feature)
    • How to get video generation status?
  • API Reference
    • API Parameter Description
    • Get user credit balance
      GET
    • Upload Image
      POST
    • Text-to-Video generation
      POST
    • Image-to-Video generation
      POST
    • Transition(First-last frame) generation
      POST
    • Get Video Generation Status
      GET
  • Trouble Shooting
    • Common errors and Solutions
    • Error codes
    • FAQ
  • Resources
    • Model & Pricing
    • Rate limit
    • Support
    • Change Logs
    • Term of Service
    • Privacy policy
  • PixVerse Tools
    • PixVerse MCP
  1. Trouble Shooting

Common errors and Solutions

Authentication Errors#

Invalid API-KEY#

Cause: The API key in your request header is incorrect or has been revoked.
Solution:
Verify you're using the correct API key
Ensure the API key is in the API-KEY header (not in the request body)
Check if your API key has expired

Parameter Errors#

Invalid parameter or Invalid binding request#

Cause: Invalid binding request: incorrect parameter type or value
Solution:
Use correct parameter type & value, here is the reference
Parameter NameTypeDescription
modelstringv3.5
img_idinteger
promptstring=< 2048 characters
negative_promptstring=< 2048 characters
template_idintegerMust activate effects in effects management before use.
Some effects don't support certain resolutions, please check effects management
stylestring"anime"
"3d_animation"
"day"
"cyberpunk"
"comic"
Do not include style parameter unless needed
motion_modestringDefault - "normal"
"fast"(only allows 5-second duration)
1080p doesn't support "fast". If not provided, defaults to normal
durationinteger5,8
1080p doesn't support 8
qualitystring"360p"(Turbo model), "540p", "720p", "1080p"
seedintegerRandom seed, int32 random number between 0 - 2147483647

Video Generation Errors#

Status code [code]#

Cause: The video generation process failed on the server side.
Solution:
if Status is 7 : check if your prompt contains prohibited content,try a different prompt or modify the existing one
if Status is 8 : Our server encountered an error during generation. Please try again. If the issue persists, please contact our customer support at api@pixverse.ai as soon as possible.

Waiting for video generating completion#

Cause: The video generation is taking longer than expectation
Solution:
Please check if you're using the same AI-trace-ID for every request.
Check your Internet connection

Image Processing Errors#

Unsupported image format#

Cause: The image file format you're trying to upload is not supported.
Solution:
Use only supported image formats: JPG, JPEG, PNG, or WEBP
Check the file extension matches the actual file format
Try converting your image to a different supported format

Image upload error (including Image size error)#

Cause: Error during the image file upload process.
Solution:
Ensure the image file cannot exceed 20M 4000px*4000px
Check if your network connection is stable
Try reducing the image file size

Rate Limiting Errors#

Reached the limit for concurrent generations.#

Cause: You have exceeded the number of videos allowed to be in "generating" status according to your current plan.
Solution:
Please check your membership privileges. If needed, consider upgrading your membership.
If a video has been "generating" for a long time, please wait 10 minutes. For videos that haven't successfully generated after 10 minutes, the system will automatically release the "generating" video count limitation.
For more assistance or to report persistent issues, please contact PixVerse technical support api@pixverse.ai
💡
When contacting us by email, please use the following format:
ID:
E-mail:
Issue encountered:
Description:
Relevant Ai-trace-ID
Previous
Get Video Generation Status
Next
Error codes