---
title: "PixVerse V5.5 - Create video from image"
method: POST
path: "/v1/ai/image-to-video/pixverse-v5-5"
tags: ["image-to-video"]
---

# PixVerse V5.5 - Create video from image

`POST /v1/ai/image-to-video/pixverse-v5-5`

## Request

- Base URL: `https://api.magnific.com`
- URL: `https://api.magnific.com/v1/ai/image-to-video/pixverse-v5-5`
- Auth: API key in header `x-magnific-api-key`

Generate a video from an image using the PixVerse-V5.5 model.

Compared to PixVerse-V5, version 5.5 adds:
- 10-second duration (in addition to 5s and 8s; 10s capped at 720p)
- Native audio generation via `generate_audio_switch`
- Multi-clip output with dynamic camera changes via `generate_multi_clip_switch`
- Prompt reasoning enhancement via `thinking_type`

## Request body

- Request4
  - `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` '360p' | '540p' | '720p' | '1080p': The resolution of the generated video
  - `aspect_ratio` 'widescreen_16_9' | 'classic_4_3' | 'square_1_1' | 'traditional_3_4' | 'social_story_9_16': The aspect ratio of the generated video
  - `duration` 5 | 8 | 10: 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.
  - `negative_prompt` string: Negative prompt to be used for the generation
  - `style` 'anime' | '3d_animation' | 'clay' | 'cyberpunk' | 'comic': The style of the generated video
  - `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` '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': The type of camera movement to apply to the video
  - `generate_audio_switch` boolean: 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: When set to true, PixVerse-V5.5 produces multi-clip output with dynamic camera changes within a single generation.
  - `thinking_type` 'enabled' | 'disabled' | 'auto': 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.
  - `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.

## Response `200`

OK

- GetStyleTransferTaskStatus200Response
  - `data` TaskDetail, required
    - `task_id` string, uuid, required: Task identifier
    - `status` 'CREATED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED', required: Task status
    - `generated` string[], required

## Other responses

- `400`: Bad Request - The server could not understand the request due to invalid syntax.
- `401`: Unauthorized - The client must authenticate itself to get the requested response.
- `500`: Internal Server Error - The server has encountered a situation it doesn't know how to handle.
- `503`: Service Unavailable

---

[API](https://skmtc.dev/magnific/apis/magnific-api.md) · [All operations](https://skmtc.dev/magnific/apis/magnific-api/llms.txt) · [OpenAPI document](https://skmtc.dev/magnific/apis/magnific-api/revisions/60711fb082c7?raw)