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

# Wan 2.5 API Documentation

> Wan 2.5 API supports native audio generation and custom audio uploads for dynamic videos. It improves motion physics, prompt awareness, and visual richness, perfect for creative projects. Integrate it now.

Check out Wan 2.5 API pricing [here](https://api.pollo.ai/pricing?modelName=wan-v2-5-preview\&modelType=video), cheaper than Fal AI.


## OpenAPI

````yaml POST /generation/wanx/wan-v2-5-preview
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/wanx/wan-v2-5-preview:
    post:
      tags:
        - generation
        - video generation
      summary: create video by text or image or reference image
      operationId: generation-wan-v2-5-preview2video
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                input:
                  anyOf:
                    - type: object
                      properties:
                        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.
                        prompt:
                          type: string
                          minLength: 1
                          maxLength: 2000
                          description: The prompt of the generation
                        negativePrompt:
                          type: string
                          maxLength: 500
                          description: The negative prompt of the generation
                        length:
                          anyOf:
                            - type: number
                              enum:
                                - 5
                            - type: number
                              enum:
                                - 10
                          default: 5
                          description: The length of the generation
                        resolution:
                          type: string
                          enum:
                            - 480P
                            - 720P
                            - 1080P
                          default: 1080P
                          description: The resolution of the generation
                        seed:
                          type: number
                          maximum: 2147483647
                          description: The seed of the generation
                        audioUrl:
                          type: string
                          format: uri
                          description: Audio URL for audio-driven generation
                        wanAudio:
                          type: boolean
                          default: true
                          description: Enable audio generation
                      required:
                        - image
                      additionalProperties: false
                      title: Image To Video
                    - type: object
                      properties:
                        prompt:
                          type: string
                          minLength: 1
                          maxLength: 2000
                          description: The prompt of the generation
                        negativePrompt:
                          type: string
                          maxLength: 500
                          description: The negative prompt of the generation
                        length:
                          anyOf:
                            - type: number
                              enum:
                                - 5
                            - type: number
                              enum:
                                - 10
                          default: 5
                          description: The length of the generation
                        resolution:
                          type: string
                          enum:
                            - 480P
                            - 720P
                            - 1080P
                          default: 1080P
                          description: The resolution of the generation
                        aspectRatio:
                          type: string
                          enum:
                            - '1:1'
                            - '4:3'
                            - '3:4'
                            - '16:9'
                            - '9:16'
                          default: '16:9'
                          description: >-
                            The aspect ratio of the generation.


                            Wan 2.5 supports all aspect ratios across all
                            resolutions.
                        seed:
                          type: number
                          maximum: 2147483647
                          description: The seed of the generation
                        audioUrl:
                          type: string
                          format: uri
                          description: Audio URL for audio-driven generation
                        wanAudio:
                          type: boolean
                          default: true
                          description: Enable audio generation
                      required:
                        - prompt
                      additionalProperties: false
                      title: Text To Video
                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

````