Pixverse 5 Video
PixVerse V5 generates cinematic videos from text and images with stunning realism and precision.
1import requests
2import json
3
4url = "https://api.segmind.com/v1/pixverse-5-video"
5headers = {
6 "x-api-key": "YOUR_API_KEY",
7 "Content-Type": "application/json"
8}
9
10data = {
11 "image_url": "https://segmind-resources.s3.amazonaws.com/input/c120a212-fd53-4801-89c5-d6ea76b07c7d-afa5eb25-9256-443a-bf91-d825872f1118.png",
12 "duration": 5,
13 "prompt": "A teenage girl sitting on a rooftop at sunset, holding a guitar on her lap, golden light reflecting on her face, cinematic medium shot, soft wind moving her hair, ultra realistic details, atmosphere of youth, creativity, and inspiration.",
14 "negative_prompt": "No sudden movements, no fast zooms.",
15 "quality": "540p",
16 "seed": 56698,
17 "motion_mode": "normal",
18 "aspect_ratio": "16:9",
19 "sound_effect_switch": true,
20 "lip_sync_switch": false
21}
22
23response = requests.post(url, headers=headers, json=data)
24
25if response.status_code == 200:
26 result = response.json()
27 print(json.dumps(result, indent=2))
28else:
29 print(f"Error: {response.status_code}")
30 print(response.text)
1import requests
2import json
3
4url = "https://api.segmind.com/v1/pixverse-5-video"
5headers = {
6 "x-api-key": "YOUR_API_KEY",
7 "Content-Type": "application/json"
8}
9
10data = {
11 "image_url": "https://segmind-resources.s3.amazonaws.com/input/c120a212-fd53-4801-89c5-d6ea76b07c7d-afa5eb25-9256-443a-bf91-d825872f1118.png",
12 "duration": 5,
13 "prompt": "A teenage girl sitting on a rooftop at sunset, holding a guitar on her lap, golden light reflecting on her face, cinematic medium shot, soft wind moving her hair, ultra realistic details, atmosphere of youth, creativity, and inspiration.",
14 "negative_prompt": "No sudden movements, no fast zooms.",
15 "quality": "540p",
16 "seed": 56698,
17 "motion_mode": "normal",
18 "aspect_ratio": "16:9",
19 "sound_effect_switch": true,
20 "lip_sync_switch": false
21}
22
23response = requests.post(url, headers=headers, json=data)
24
25if response.status_code == 200:
26 result = response.json()
27 print(json.dumps(result, indent=2))
28else:
29 print(f"Error: {response.status_code}")
30 print(response.text)
API Endpoint
https://api.segmind.com/v1/pixverse-5-video
Parameters
duration
requiredinteger
Video duration in seconds (5 or 8; only 5 is allowed for fast mode or 1080p quality)
5
5
8
motion_mode
requiredstring
Motion mode (normal, fast, --fast only available when duration=5; --quality=1080p does not support fast)
"normal"
"normal"
prompt
requiredstring
Prompt describing the animation
quality
requiredstring
Video quality (360p, 540p, 720p, 1080p)
"540p"
"360p"
"540p"
"720p"
"1080p"
aspect_ratio
optionalstring
Aspect ratio options: 16:9, 4:3, 1:1, 3:4, and 9:16. If a reference image is provided, its aspect ratio will be used instead, and the specified aspect_ratio will be ignored.
"16:9"
"16:9"
"4:3"
"1:1"
"3:4"
"9:16"
image_url
optionalstring (uri)
Provide the URL of the image to be relit. Use a URL from cloud storage like S3.
lip_sync_switch
optionalboolean
Lip Sync Switch
false
lip_sync_tts_content
optionalstring
Lip Sync TTS Content
null
lip_sync_tts_speaker_id
optionalstring
Select a voice for text-to-speech. Use 'auto' for a natural, engaging voice.
null
"auto"
"1"
"2"
"3"
"4"
"5"
"6"
"7"
"8"
"9"
negative_prompt
optionalstring
Negative prompt (unwanted effects)
"No sudden movements, no fast zooms."
seed
optionalinteger
Seed for random generation
sound_effect_content
optionalstring
Sound Effect Content
null
sound_effect_switch
optionalboolean
Sound Effect Switch
true
style
optionalstring
Style (only for model=v3.5): anime, 3d_animation, clay, comic, cyberpunk
null
"anime"
"3d_animation"
"clay"
"comic"
"cyberpunk"
Response Type
Returns: Video
Common Error Codes
The API returns standard HTTP status codes. Detailed error messages are provided in the response body.
Bad Request
Invalid parameters or request format
Unauthorized
Missing or invalid API key
Forbidden
Insufficient permissions
Not Found
Model or endpoint not found
Insufficient Credits
Not enough credits to process request
Rate Limited
Too many requests
Server Error
Internal server error
Bad Gateway
Service temporarily unavailable
Timeout
Request timed out