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

# PixVerse V5.5 - Create video from image

> 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`




## OpenAPI

````yaml post /v1/ai/image-to-video/pixverse-v5-5
openapi: 3.0.0
info:
  description: >-
    The Magnific API is your gateway to a vast collection of high-quality
    digital resources for your applications and projects. As a leading platform,
    it offers a wide range of graphics, including vectors, photos,
    illustrations, icons, PSD templates, and more, all curated by talented
    designers from around the world.
  title: Magnific API
  version: 1.0.0
servers:
  - description: B2B API Production V1
    url: https://api.magnific.com
security:
  - magnificApiKey: []
paths:
  /v1/ai/image-to-video/pixverse-v5-5:
    post:
      tags:
        - image-to-video
      summary: PixVerse V5.5 - Create video from image
      description: >
        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`
      operationId: create_pixverse_v5_5_video
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/request_4'
        required: true
      responses:
        '200':
          content:
            application/json:
              examples:
                success - in progress task:
                  $ref: '#/components/examples/200-task-in-progress'
              schema:
                $ref: >-
                  #/components/schemas/get_style_transfer_task_status_200_response
          description: OK
        '400':
          $ref: '#/components/responses/400-bad-request'
        '401':
          $ref: '#/components/responses/401-unauthorized'
        '500':
          $ref: '#/components/responses/500-internal-server-error'
        '503':
          $ref: '#/components/responses/503-service-unavailable'
components:
  schemas:
    request_4:
      properties:
        prompt:
          description: Prompt describing the video to generate
          type: string
        image_url:
          description: URL of the image to use as the first frame
          format: uri
          type: string
        resolution:
          $ref: '#/components/schemas/resolution_4'
        aspect_ratio:
          $ref: '#/components/schemas/aspect-ratio_3'
        duration:
          default: 5
          description: >-
            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.
          enum:
            - 5
            - 8
            - 10
          type: integer
        negative_prompt:
          default: ''
          description: Negative prompt to be used for the generation
          type: string
        style:
          $ref: '#/components/schemas/style-enum'
        seed:
          description: >-
            The same seed and the same prompt given to the same version of the
            model will output the same video every time
          type: integer
        camera_movement:
          $ref: '#/components/schemas/camera-movement'
        generate_audio_switch:
          default: false
          description: >-
            When set to true, PixVerse-V5.5 generates synchronized audio
            (background music, sound effects, or dialogue) together with the
            video.
          type: boolean
        generate_multi_clip_switch:
          default: false
          description: >-
            When set to true, PixVerse-V5.5 produces multi-clip output with
            dynamic camera changes within a single generation.
          type: boolean
        thinking_type:
          $ref: '#/components/schemas/thinking-type'
        webhook_url:
          description: >
            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
          format: uri
          type: string
      required:
        - image_url
        - prompt
      type: object
    get_style_transfer_task_status_200_response:
      example:
        data:
          generated:
            - https://openapi-generator.tech
            - https://openapi-generator.tech
          task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          status: CREATED
      properties:
        data:
          $ref: '#/components/schemas/task-detail'
      required:
        - data
      type: object
    resolution_4:
      description: The resolution of the generated video
      enum:
        - 360p
        - 540p
        - 720p
        - 1080p
      type: string
    aspect-ratio_3:
      default: widescreen_16_9
      description: The aspect ratio of the generated video
      enum:
        - widescreen_16_9
        - classic_4_3
        - square_1_1
        - traditional_3_4
        - social_story_9_16
      type: string
    style-enum:
      description: The style of the generated video
      enum:
        - anime
        - 3d_animation
        - clay
        - cyberpunk
        - comic
      example: anime
      type: string
    camera-movement:
      description: The type of camera movement to apply to the video
      enum:
        - 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
      type: string
    thinking-type:
      default: enabled
      description: >
        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.
      enum:
        - enabled
        - disabled
        - auto
      type: string
    task-detail:
      allOf:
        - $ref: '#/components/schemas/task'
        - properties:
            generated:
              items:
                description: URL of the generated image
                format: uri
                type: string
              type: array
          required:
            - generated
          type: object
      example:
        generated:
          - https://openapi-generator.tech
          - https://openapi-generator.tech
        task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        status: CREATED
    inline_object:
      example:
        message: message
      properties:
        message:
          type: string
      type: object
    inline_object_1:
      properties:
        problem:
          $ref: '#/components/schemas/inline_object_1_problem'
      type: object
    inline_object_2:
      example:
        message: Internal Server Error
      properties:
        message:
          example: Internal Server Error
          type: string
      type: object
    inline_object_3:
      example:
        message: Service Unavailable. Please try again later.
      properties:
        message:
          example: Service Unavailable. Please try again later.
          type: string
      type: object
    task:
      example:
        task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        status: CREATED
      properties:
        task_id:
          description: Task identifier
          format: uuid
          type: string
        status:
          description: Task status
          enum:
            - CREATED
            - IN_PROGRESS
            - COMPLETED
            - FAILED
          type: string
      required:
        - status
        - task_id
      type: object
    inline_object_1_problem:
      properties:
        message:
          example: Validation error
          type: string
        invalid_params:
          items:
            $ref: '#/components/schemas/inline_object_1_problem_invalid_params_inner'
          type: array
      required:
        - invalid_params
        - message
      type: object
    inline_object_1_problem_invalid_params_inner:
      properties:
        name:
          description: Name of the invalid parameter.
          example: page
          type: string
        field:
          description: Field of the invalid parameter. Mirrors `name`.
          example: page
          type: string
        reason:
          example: Parameter 'page' must be greater than 0
          type: string
      required:
        - field
        - name
        - reason
      type: object
  examples:
    200-task-in-progress:
      summary: Success - Task in progress
      value:
        data:
          generated: []
          task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          status: IN_PROGRESS
  responses:
    400-bad-request:
      content:
        application/json:
          examples:
            invalid_page:
              summary: Parameter 'page' is not valid
              value:
                message: Parameter 'page' must be greater than 0
            invalid_query:
              summary: Parameter 'query' is not valid
              value:
                message: Parameter 'query' must not be empty
            invalid_filter:
              summary: Parameter 'filter' is not valid
              value:
                message: Parameter 'filter' is not valid
            generic_bad_request:
              summary: Bad Request
              value:
                message: Parameter ':attribute' is not valid
          schema:
            $ref: '#/components/schemas/inline_object'
        application/problem+json:
          examples:
            invalid_page:
              summary: Parameter 'page' is not valid
              value:
                message: Validation error
                invalid_params:
                  - field: page
                    reason: Parameter 'page' must be greater than 0
                  - field: per_page
                    reason: Parameter 'per_page' must be greater than 0
          schema:
            $ref: '#/components/schemas/inline_object_1'
      description: >-
        Bad Request - The server could not understand the request due to invalid
        syntax.
    401-unauthorized:
      content:
        application/json:
          examples:
            invalid_api_key:
              summary: API key is not valid
              value:
                message: Invalid API key
            missing_api_key:
              summary: API key is not provided
              value:
                message: Missing API key
          schema:
            $ref: '#/components/schemas/inline_object'
      description: >-
        Unauthorized - The client must authenticate itself to get the requested
        response.
    500-internal-server-error:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/inline_object_2'
      description: >-
        Internal Server Error - The server has encountered a situation it
        doesn't know how to handle.
    503-service-unavailable:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/inline_object_3'
      description: Service Unavailable
  securitySchemes:
    magnificApiKey:
      description: >
        Your Magnific API key. Required for authentication. [Learn how to obtain
        an API key](https://docs.magnific.com/quickstart)
      in: header
      name: x-magnific-api-key
      type: apiKey

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.