> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pollo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Vidu 2.0 API Documentation

> Vidu 2.0 is an AI video generation API that creates videos by combining reference images with text prompts. It uses advanced technology to keep characters, objects, and environments consistent throughout the video, ensuring smooth and natural animations. Learn how to integrate it below.

Check out Vidu 2.0 API pricing [here](https://api.pollo.ai/pricing?modelName=vidu-v2-0\&modelType=video), cheaper than Fal AI.


## OpenAPI

````yaml POST /generation/vidu/vidu-v2-0
openapi: 3.0.3
info:
  title: Pollo | AI Video Collection
  description: ✨RESTful API Document
  version: 1.0.0
servers:
  - url: https://pollo.ai/api/platform
security: []
externalDocs:
  url: https://pollo.ai/api/platform/api/openapi.json
paths:
  /generation/vidu/vidu-v2-0:
    post:
      tags:
        - generation
        - video generation
      summary: create video by text or image or reference image
      operationId: generation-vidu-v2-02video
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                input:
                  type: object
                  properties:
                    prompt:
                      type: string
                      maxLength: 2500
                      description: The prompt of the generation
                    image:
                      type: string
                      format: uri
                      description: >-
                        Only image URLs are accepted (HTTPS preferred); base64
                        is not allowed.
                                    Supported formats include JPG, PNG, and JPEG.
                                    Image aspect ratio must be less than 1:4 or 4:1.
                    length:
                      type: number
                      enum:
                        - 4
                        - 8
                      default: 4
                      description: The length of the generation
                    resolution:
                      anyOf:
                        - type: string
                          enum:
                            - 720p
                        - type: string
                          enum:
                            - 1080p
                      default: 720p
                      description: The resolution of the generation
                    imageTail:
                      type: string
                      format: uri
                      description: |-
                        URL of the tail image for video generation.
                                    Only image URLs are accepted (HTTPS preferred); base64 is not allowed.
                                    Supported formats include JPG, PNG, and JPEG.
                                    Image aspect ratio must be less than 1:4 or 4:1.
                    movementAmplitude:
                      type: string
                      enum:
                        - auto
                        - small
                        - medium
                        - large
                      default: auto
                    seed:
                      type: number
                      description: The seed of the generation
                  required:
                    - image
                  additionalProperties: false
                webhookUrl:
                  type: string
                clientSource:
                  type: string
                  minLength: 1
                  maxLength: 100
              required:
                - input
              additionalProperties: false
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  taskId:
                    type: string
                  status:
                    type: string
                    enum:
                      - waiting
                      - succeed
                      - failed
                      - processing
                required:
                  - taskId
                  - status
                additionalProperties: false
        default:
          $ref: '#/components/responses/error'
      security:
        - ApiKeyAuth: []
components:
  responses:
    error:
      description: Error response
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
              code:
                type: string
              issues:
                type: array
                items:
                  type: object
                  properties:
                    message:
                      type: string
                  required:
                    - message
                  additionalProperties: false
            required:
              - message
              - code
            additionalProperties: false
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key to authorize requests

````