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

> Wan 2.7 API enables multi-shot videos with stable characters, extended narratives, natural motion, and cinematic camera moves. Maintain visual consistency across scenes and languages. Integrate the Wan 2.7 API now.

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


## OpenAPI

````yaml POST /v1/generation/alibaba/wan-v2-7/video
openapi: 3.0.3
info:
  title: Pollo | AI Video Collection
  description: >-
    ✨RESTful API Document. Model discovery: GET /api/v1/model-specs (public,
    keyless).
  version: 1.0.0
servers:
  - url: https://pollo.ai/api/platform
security: []
externalDocs:
  url: https://pollo.ai/api/platform/api/openapi.json
paths:
  /v1/generation/alibaba/wan-v2-7/video:
    post:
      tags:
        - Video
      summary: wan-v2-7
      operationId: v1-alibaba/wan-v2-7/video
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - input
              properties:
                input:
                  oneOf:
                    - type: object
                      properties:
                        audio:
                          type: string
                          description: Reference audio URL (HTTP(S)).
                        prompt:
                          type: string
                          maxLength: 5000
                          minLength: 1
                          description: Text prompt describing the content to generate.
                        negativePrompt:
                          type: string
                          maxLength: 500
                          description: >-
                            Text describing elements to avoid in the generated
                            output.
                        image:
                          type: string
                          description: >-
                            First-frame / reference image URL (HTTP(S); base64
                            not allowed). Supported formats: JPG/JPEG, PNG.
                            Aspect ratio must be within 1:4 to 4:1.
                        imageTail:
                          type: string
                          description: >-
                            Tail (end-frame) image URL (HTTP(S); base64 not
                            allowed). Supported formats: JPG/JPEG, PNG. Aspect
                            ratio must be within 1:4 to 4:1.
                        duration:
                          type: integer
                          minimum: 2
                          maximum: 15
                          default: 5
                          description: The duration of the generated video, in seconds.
                        resolution:
                          type: string
                          enum:
                            - 1080p
                            - 720p
                          default: 720p
                          description: >-
                            Output resolution of the generated media (e.g. 720p,
                            1080p, 2K, 4K). Values are case-insensitive.
                        seed:
                          type: number
                          minimum: 0
                          maximum: 2147483647
                          description: Random seed for reproducible generation.
                      required:
                        - image
                      title: Image To Video
                    - type: object
                      properties:
                        audio:
                          type: string
                          description: Reference audio URL (HTTP(S)).
                        prompt:
                          type: string
                          maxLength: 5000
                          minLength: 1
                          description: Text prompt describing the content to generate.
                        negativePrompt:
                          type: string
                          maxLength: 500
                          description: >-
                            Text describing elements to avoid in the generated
                            output.
                        duration:
                          type: integer
                          minimum: 2
                          maximum: 15
                          default: 5
                          description: The duration of the generated video, in seconds.
                        resolution:
                          type: string
                          enum:
                            - 1080p
                            - 720p
                          default: 720p
                          description: >-
                            Output resolution of the generated media (e.g. 720p,
                            1080p, 2K, 4K). Values are case-insensitive.
                        aspectRatio:
                          type: string
                          enum:
                            - '16:9'
                            - '1:1'
                            - '4:3'
                            - '3:4'
                            - '9:16'
                          default: '16:9'
                          description: Output aspect ratio, as width:height (e.g. 16:9).
                        seed:
                          type: number
                          minimum: 0
                          maximum: 2147483647
                          description: Random seed for reproducible generation.
                      required:
                        - prompt
                      title: Text To Video
                    - type: object
                      properties:
                        refs:
                          type: array
                          items:
                            $ref: '#/components/schemas/Ref'
                          maxItems: 10
                          description: >-
                            Reference items (image / video / audio) for
                            reference-to-video generation.
                        prompt:
                          type: string
                          maxLength: 5000
                          minLength: 1
                          description: Text prompt describing the content to generate.
                        negativePrompt:
                          type: string
                          maxLength: 500
                          description: >-
                            Text describing elements to avoid in the generated
                            output.
                        duration:
                          type: integer
                          minimum: 2
                          maximum: 15
                          default: 5
                          description: The duration of the generated video, in seconds.
                        aspectRatio:
                          type: string
                          enum:
                            - '1:1'
                            - '4:3'
                            - '3:4'
                            - '16:9'
                            - '9:16'
                          default: '16:9'
                          description: Output aspect ratio, as width:height (e.g. 16:9).
                        resolution:
                          type: string
                          enum:
                            - 720p
                            - 1080p
                          default: 720p
                          description: >-
                            Output resolution of the generated media (e.g. 720p,
                            1080p, 2K, 4K). Values are case-insensitive.
                        seed:
                          type: number
                          minimum: 0
                          maximum: 2147483647
                          description: Random seed for reproducible generation.
                      required:
                        - refs
                        - prompt
                      title: Reference To Video
                      description: >-
                        Constraints:

                        - when a video ref is included, duration must be at most
                        10 seconds
                webhookUrl:
                  type: string
                  format: uri
                  description: >-
                    Webhook URL (HTTP(S)) that receives status callbacks when
                    the generation succeeds or fails.
      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:
  schemas:
    Ref:
      type: object
      required:
        - url
      description: A reference item specifying url / type.
      properties:
        url:
          type: string
          description: Media URL (HTTP(S)).
          example: https://example.com/ref.jpg
        type:
          type: string
          enum:
            - image
            - video
            - audio
          description: Media kind. Auto-detected from the URL when omitted.
  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

````