Pixverse Image to Video Serverless API

Animate your photos effortlessly with Pixverse Image to Video AI! Upload, add motion prompts and styles.

~41.08s

$0.375 - $1.00 per generation

~41.08s

$0.375 - $1.00 per generation

 1import requests
 2import json
 3
 4url = "https://api.segmind.com/v1/pixverse-image2video"
 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/783a73f1-bdf8-441c-982c-b7cd75d80df9-pixverse-i2v-ip.webp",
12    "duration": 5,
13    "prompt": "Subject dance takes the world by storm!",
14    "negative_prompt": "No sudden movements, no fast zooms.",
15    "quality": "540p",
16    "seed": 56698,
17    "motion_mode": "normal"
18}
19
20response = requests.post(url, headers=headers, json=data)
21
22if response.status_code == 200:
23    result = response.json()
24    print(json.dumps(result, indent=2))
25else:
26    print(f"Error: {response.status_code}")
27    print(response.text)

 1import requests
 2import json
 3
 4url = "https://api.segmind.com/v1/pixverse-image2video"
 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/783a73f1-bdf8-441c-982c-b7cd75d80df9-pixverse-i2v-ip.webp",
12    "duration": 5,
13    "prompt": "Subject dance takes the world by storm!",
14    "negative_prompt": "No sudden movements, no fast zooms.",
15    "quality": "540p",
16    "seed": 56698,
17    "motion_mode": "normal"
18}
19
20response = requests.post(url, headers=headers, json=data)
21
22if response.status_code == 200:
23    result = response.json()
24    print(json.dumps(result, indent=2))
25else:
26    print(f"Error: {response.status_code}")
27    print(response.text)

API Endpoint

POSThttps://api.segmind.com/v1/pixverse-image2video

Parameters

durationrequired

integer

Video duration in seconds (5 or 8; only 5 is allowed for fast mode or 1080p quality)

Default: 5

Allowed values :

58

image_urlrequired

string (uri)

Provide the URL of the image to be relit. Use a URL from cloud storage like S3.

motion_moderequired

string

Motion mode (normal, fast, --fast only available when duration=5; --quality=1080p does not support fast)

Default: "normal"

Allowed values :

"normal""fast"

promptrequired

string

Prompt describing the animation

qualityrequired

string

Video quality (360p, 540p, 720p, 1080p)

Default: "540p"

Allowed values :

"360p""540p""720p""1080p"

negative_promptoptional

string

Negative prompt (unwanted effects)

Default: "No sudden movements, no fast zooms."

seedoptional

integer

Seed for random generation

Range: 1 - 99999

styleoptional

string

Style (only for model=v3.5): anime, 3d_animation, clay, comic, cyberpunk

Default: null

Allowed values :

"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.

400

Bad Request

Invalid parameters or request format

401

Unauthorized

Missing or invalid API key

403

Forbidden

Insufficient permissions

404

Not Found

Model or endpoint not found

406

Insufficient Credits

Not enough credits to process request

429

Rate Limited

Too many requests

500

Server Error

Internal server error

502

Bad Gateway

Service temporarily unavailable

504

Timeout

Request timed out