> ## 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 3.0 Prime API Documentation

> Wan 3.0 Prime API supports multimodal video generation from text, images, video, and audio. It creates longer sequences with native dialogue, music, and sound effects while preserving references across shots. Integrate the Wan 3.0 Prime API now.

Check out Wan 3.0 Prime API pricing [here](https://api.pollo.ai/pricing?modelName=wan-v3-0-prime\&modelType=video), cheaper than Fal AI.


## OpenAPI

````yaml POST /v1/generation/alibaba/wan-v3-0-prime/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-v3-0-prime/video:
    post:
      tags:
        - Video
      summary: wan-v3-0-prime
      operationId: v1-alibaba/wan-v3-0-prime/video
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - input
              properties:
                input:
                  oneOf:
                    - type: object
                      properties:
                        prompt:
                          type: string
                          maxLength: 20000
                          description: Text prompt describing the content to generate.
                        image:
                          type: string
                          description: First-frame / reference image URL (HTTP(S).
                        imageTail:
                          type: string
                          description: Tail (end-frame) image URL
                        duration:
                          type: integer
                          minimum: 2
                          maximum: 30
                          default: 5
                          description: The duration of the generated video, in seconds.
                        resolution:
                          type: string
                          enum:
                            - 480p
                            - 720p
                            - 1080p
                          default: 480p
                          description: >-
                            Output resolution of the generated media (e.g. 720p,
                            1080p, 2K, 4K). Values are case-insensitive.
                        generateAudio:
                          type: boolean
                          default: true
                          description: >-
                            Generate natural-sounding, fitting audio for the
                            output video.
                        seed:
                          type: integer
                          minimum: 0
                          maximum: 2147483647
                          description: Random seed for reproducible generation.
                      required:
                        - image
                      title: Image To Video
                    - type: object
                      properties:
                        prompt:
                          type: string
                          maxLength: 20000
                          minLength: 1
                          description: Text prompt describing the content to generate.
                        duration:
                          type: integer
                          minimum: 2
                          maximum: 30
                          default: 5
                          description: The duration of the generated video, in seconds.
                        resolution:
                          type: string
                          enum:
                            - 480p
                            - 720p
                            - 1080p
                          default: 480p
                          description: >-
                            Output resolution of the generated media (e.g. 720p,
                            1080p, 2K, 4K). Values are case-insensitive.
                        aspectRatio:
                          type: string
                          enum:
                            - adaptive
                            - '16:9'
                            - '9:16'
                            - '4:3'
                            - '3:4'
                            - '1:1'
                          default: adaptive
                          description: Output aspect ratio, as width:height (e.g. 16:9).
                        generateAudio:
                          type: boolean
                          default: true
                          description: >-
                            Generate natural-sounding, fitting audio for the
                            output video.
                        seed:
                          type: integer
                          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/RefImageVideoAudioFileLink'
                          maxItems: 22
                          description: >-
                            Reference items (image / video / audio) for
                            reference-to-video generation.
                        prompt:
                          type: string
                          maxLength: 20000
                          minLength: 1
                          description: Text prompt describing the content to generate.
                        duration:
                          type: integer
                          minimum: 2
                          maximum: 30
                          default: 5
                          description: The duration of the generated video, in seconds.
                        aspectRatio:
                          type: string
                          enum:
                            - adaptive
                            - '16:9'
                            - '9:16'
                            - '4:3'
                            - '3:4'
                            - '1:1'
                          default: adaptive
                          description: Output aspect ratio, as width:height (e.g. 16:9).
                        resolution:
                          type: string
                          enum:
                            - 480p
                            - 720p
                            - 1080p
                          default: 480p
                          description: >-
                            Output resolution of the generated media (e.g. 720p,
                            1080p, 2K, 4K). Values are case-insensitive.
                        generateAudio:
                          type: boolean
                          default: true
                          description: >-
                            Generate natural-sounding, fitting audio for the
                            output video.
                        seed:
                          type: integer
                          minimum: 0
                          maximum: 2147483647
                          description: Random seed for reproducible generation.
                      required:
                        - refs
                        - prompt
                      title: Reference To Video
                      description: >-
                        Constraints:

                        - Wan 3.0 supports at most 10 reference images, 5
                        videos, 5 audios, 1 document and 1 web page

                        - Wan 3.0 requires at least one reference image, video,
                        document or web page

                        - Wan 3.0 cannot take a document and a web page
                        reference at the same time
                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
        '400':
          $ref: '#/components/responses/ApiError400'
        '401':
          $ref: '#/components/responses/ApiError401'
        '403':
          $ref: '#/components/responses/ApiError403'
        '404':
          $ref: '#/components/responses/ApiError404'
        '429':
          $ref: '#/components/responses/ApiError429'
        '500':
          $ref: '#/components/responses/ApiError500'
        default:
          $ref: '#/components/responses/error'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    RefImageVideoAudioFileLink:
      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
            - file
            - link
          description: Media kind. Auto-detected from the URL when omitted.
    ApiError:
      type: object
      required:
        - errorCode
        - message
        - code
      additionalProperties: true
      properties:
        errorCode:
          type: string
          enum:
            - REJECTED
            - INTERNAL
            - CREDENTIAL_MISSING
            - CREDENTIAL_INVALID
            - CLI_TOKEN_EXPIRED
            - CLI_REFRESH_TOKEN_INVALID
            - PERMISSION_DENIED
            - ACCOUNT_SUSPENDED
            - ACCOUNT_DELETED
            - CREDITS_INSUFFICIENT
            - PLAN_FEATURE_REQUIRED
            - PARALLEL_TASK_LIMIT_REACHED
            - ACTIVITY_DAILY_LIMIT_REACHED
            - QUOTA_ELEMENT_FREE
            - QUOTA_ELEMENT_PAID
            - QUOTA_BRAND_KIT_FREE
            - QUOTA_BRAND_KIT_PAID
            - RATE_LIMIT_EXCEEDED
            - RATE_LIMIT_PRODUCT_EXTRACT
            - INPUT_VALIDATION_FAILED
            - MODERATION_REJECTED
            - ASSET_DISABLED_BY_REVIEW
            - GENERATION_IN_PROGRESS
          description: >-
            Stable business error identifier — **the only field to branch on**.
            Codes are append-only: existing codes are never renamed or
            repurposed, but new ones are added over time, so treat this as an
            open set. Match the exact code you handle, else the family prefix
            (`MODERATION_`, `RATE_LIMIT_`, `QUOTA_`, `ACCOUNT_`, …), else fall
            back to the HTTP status.
        message:
          type: string
          description: >-
            Developer-facing text. Varies with locale and product copy — **never
            match on it**.
        code:
          type: string
          description: >-
            Transport-level code (tRPC / JSON-RPC naming). Deprecated for
            business logic; may be removed.
        requestId:
          type: string
          description: Correlation id — quote it when contacting support.
        issues:
          type: array
          description: >-
            Per-field validation detail. Present when `errorCode` is
            `INPUT_VALIDATION_FAILED`.
          items:
            type: object
            required:
              - message
            additionalProperties: true
            properties:
              message:
                type: string
              path:
                type: array
                items:
                  type: string
                description: Path to the offending field.
  responses:
    ApiError400:
      description: >-
        Invalid request — schema validation failed (`INPUT_VALIDATION_FAILED`,
        detail in `issues`), a cross-field constraint was violated
        (`INPUT_CONSTRAINT_VIOLATED`), or the input did not pass moderation
        (`MODERATION_*`).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    ApiError401:
      description: >-
        Missing or invalid credential (`CREDENTIAL_*`, `CLI_TOKEN_EXPIRED`,
        `EMAIL_LOGIN_REQUIRED`).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    ApiError403:
      description: >-
        Rejected — not enough credits (`CREDITS_INSUFFICIENT`), quota exhausted
        (`QUOTA_*`), plan required (`PLAN_FEATURE_REQUIRED`), account state
        (`ACCOUNT_*`), or no permission (`PERMISSION_DENIED`).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    ApiError404:
      description: >-
        Nothing matched — unknown route, model (`MODEL_NOT_FOUND`), task
        (`TASK_NOT_FOUND`) or asset (`ASSET_NOT_FOUND`).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    ApiError429:
      description: >-
        Rate limited (`RATE_LIMIT_*`). `RATE_LIMIT_MODERATION` means recent
        content was blocked — adjust the input rather than simply retrying.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    ApiError500:
      description: Unexpected server-side failure (`INTERNAL`).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    error:
      description: >-
        Error response. Every failure on this API uses this shape; branch on
        `errorCode`.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key to authorize requests

````