Skip to main content
POST
/
v1
/
ai
/
image-to-video
/
pixverse-v5-5
PixVerse V5.5 - Create video from image
curl --request POST \
  --url https://api.magnific.com/v1/ai/image-to-video/pixverse-v5-5 \
  --header 'Content-Type: application/json' \
  --header 'x-magnific-api-key: <api-key>' \
  --data '
{
  "prompt": "<string>",
  "image_url": "<string>",
  "aspect_ratio": "widescreen_16_9",
  "duration": 5,
  "negative_prompt": "",
  "style": "anime",
  "seed": 123,
  "generate_audio_switch": false,
  "generate_multi_clip_switch": false,
  "thinking_type": "enabled",
  "webhook_url": "https://www.example.com/webhook"
}
'
{
  "data": {
    "generated": [],
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "IN_PROGRESS"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.magnific.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-magnific-api-key
string
header
required

Your Magnific API key. Required for authentication. Learn how to obtain an API key

Body

application/json
​
prompt
string
required

Prompt describing the video to generate

​
image_url
string<uri>
required

URL of the image to use as the first frame

​
resolution
enum<string>

The resolution of the generated video

Available options:
360p,
540p,
720p,
1080p
​
aspect_ratio
enum<string>
default:widescreen_16_9

The aspect ratio of the generated video

Available options:
widescreen_16_9,
classic_4_3,
square_1_1,
traditional_3_4,
social_story_9_16
​
duration
enum<integer>
default:5

The duration of the generated video in seconds. 8s videos cost double. 10s videos are only available up to 720p. 1080p videos are limited to 5 or 8 seconds.

Available options:
5,
8,
10
​
negative_prompt
string
default:""

Negative prompt to be used for the generation

​
style
enum<string>

The style of the generated video

Available options:
anime,
3d_animation,
clay,
cyberpunk,
comic
Example:

"anime"

​
seed
integer

The same seed and the same prompt given to the same version of the model will output the same video every time

​
camera_movement
enum<string>

The type of camera movement to apply to the video

Available options:
horizontal_left,
horizontal_right,
vertical_up,
vertical_down,
zoom_in,
zoom_out,
crane_up,
quickly_zoom_in,
quickly_zoom_out,
smooth_zoom_in,
camera_rotation,
robo_arm,
super_dolly_out,
whip_pan,
hitchcock,
left_follow,
right_follow,
pan_left,
pan_right,
fix_bg
​
generate_audio_switch
boolean
default:false

When set to true, PixVerse-V5.5 generates synchronized audio (background music, sound effects, or dialogue) together with the video.

​
generate_multi_clip_switch
boolean
default:false

When set to true, PixVerse-V5.5 produces multi-clip output with dynamic camera changes within a single generation.

​
thinking_type
enum<string>
default:enabled

Prompt reasoning enhancement mode. Controls how PixVerse-V5.5 optimizes the input prompt before generation.

  • enabled - The model rewrites the prompt automatically for better results.
  • disabled - The prompt is used exactly as written, with no rewriting.
  • auto - The model decides whether to rewrite the prompt based on the input.
Available options:
enabled,
disabled,
auto
​
webhook_url
string<uri>

Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.

Example:

"https://www.example.com/webhook"

Response

OK

​
data
object
required
Example:
{
  "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
  "status": "CREATED",
  "generated": [
    "https://openapi-generator.tech",
    "https://openapi-generator.tech"
  ]
}