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

# Wan 3.0 T2V

> [Core Function] Wan 3.0 T2V is Alibaba Wan 3.0 text-to-video generation with optional document or webpage reference. [Strengths] It generates up to 30-second video at 480P/720P/1080P with controllable aspect ratio and optional output audio, and can ground generation on a file or public webpage. [Best For] Highly recommended for: pure text-to-video storytelling, product ads driven by pptx/pdf briefs, turning public articles into short videos, and square or vertical social clips. [Limitations] At least one of prompt, file_url, or link_url is required; an empty body is rejected. Do NOT pass file_url and link_url together. Do NOT use this model if the user provides images or videos as primary media; route those to Wan 3.0 I2V or V2V. [Routing] Prefer this model for Wan 3.0 text-only or file/link-to-video. Use Wan 3.0 I2V for first-frame or reference-image workflows, and Wan 3.0 V2V when reference video is required.



## OpenAPI

````yaml /media-model-api/alibaba/alibaba-t2v.json post /alibaba/wan3.0-t2v
openapi: 3.1.0
info:
  description: The text-to-video models API from Alibaba.
  version: 1.0.0
  contact:
    name: Modellix Support
    email: support@modellix.ai
  title: Alibaba Text-to-Video Models API
servers:
  - url: https://api.modellix.ai/api/v1
    description: The text-to-video models API from Alibaba.
security:
  - bearerAuth: []
paths:
  /alibaba/wan3.0-t2v:
    post:
      summary: Wan 3.0 T2V
      description: >-
        [Core Function] Wan 3.0 T2V is Alibaba Wan 3.0 text-to-video generation
        with optional document or webpage reference. [Strengths] It generates up
        to 30-second video at 480P/720P/1080P with controllable aspect ratio and
        optional output audio, and can ground generation on a file or public
        webpage. [Best For] Highly recommended for: pure text-to-video
        storytelling, product ads driven by pptx/pdf briefs, turning public
        articles into short videos, and square or vertical social clips.
        [Limitations] At least one of prompt, file_url, or link_url is required;
        an empty body is rejected. Do NOT pass file_url and link_url together.
        Do NOT use this model if the user provides images or videos as primary
        media; route those to Wan 3.0 I2V or V2V. [Routing] Prefer this model
        for Wan 3.0 text-only or file/link-to-video. Use Wan 3.0 I2V for
        first-frame or reference-image workflows, and Wan 3.0 V2V when reference
        video is required.
      operationId: wan30T2vAsync
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Wan30T2vRequest'
            examples:
              basic:
                summary: Basic text-to-video
                value:
                  prompt: A cute cat running on a moonlit rooftop, cinematic.
              advanced:
                summary: With generation parameters
                value:
                  prompt: Epic dragon flying over mountains with dramatic lighting
                  resolution: 1080P
                  ratio: '1:1'
                  duration: 10
                  audio: true
                  seed: 12345
              reference_file:
                summary: Reference file to video
                value:
                  prompt: A premium smart glasses product ad, minimal and futuristic
                  file_url: https://example.com/glass.pptx
                  resolution: 480P
                  duration: 10
              reference_file_only:
                summary: file_url alone (prompt optional)
                value:
                  file_url: https://example.com/glass.pptx
                  resolution: 720P
                  duration: 8
              reference_link:
                summary: Reference webpage to video
                value:
                  prompt: Summarize the article as a short cinematic video
                  link_url: https://example.com/article
                  ratio: '9:16'
                  duration: 8
      responses:
        '200':
          description: Task submitted successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AsyncTaskResponse'
components:
  schemas:
    Wan30T2vRequest:
      type: object
      description: >-
        At least one of prompt, file_url, or link_url is required (anyOf below).
        file_url and link_url are mutually exclusive.
        resolution/ratio/duration/audio have defaults when omitted.
      properties:
        prompt:
          type: string
          description: >-
            Text prompt describing the desired video content. Supports Chinese
            and English. Max 20000 characters. Required unless file_url or
            link_url is provided.
          minLength: 1
          maxLength: 20000
          example: A cute cat running on a moonlit rooftop, cinematic.
        file_url:
          type: string
          format: uri
          description: >-
            Reference file URL. Supported formats: docx, doc, xlsx, xls, pptx,
            ppt, pdf, txt, key, pages, numbers, md. Max 100MB; page-based
            formats up to 50 pages. HTTP/HTTPS or oss:// temporary URL. Mutually
            exclusive with link_url. May be used alone or with prompt.
          example: https://example.com/glass.pptx
        link_url:
          type: string
          format: uri
          description: >-
            Public webpage URL that does not require login. HTTP/HTTPS only.
            Mutually exclusive with file_url. May be used alone or with prompt.
          example: https://example.com/article
        resolution:
          type: string
          description: Specifies the resolution tier for the generated video
          enum:
            - 480P
            - 720P
            - 1080P
          default: 1080P
          example: 1080P
        ratio:
          type: string
          description: Specifies the aspect ratio for the generated video
          enum:
            - '16:9'
            - '4:3'
            - '1:1'
            - '3:4'
            - '9:16'
          default: '1:1'
          example: '1:1'
        duration:
          type: integer
          description: Video duration in seconds. Allowed values are integers from 2 to 30
          enum:
            - 2
            - 3
            - 4
            - 5
            - 6
            - 7
            - 8
            - 9
            - 10
            - 11
            - 12
            - 13
            - 14
            - 15
            - 16
            - 17
            - 18
            - 19
            - 20
            - 21
            - 22
            - 23
            - 24
            - 25
            - 26
            - 27
            - 28
            - 29
            - 30
          default: 5
          example: 5
        audio:
          type: boolean
          description: Whether the output video includes an audio track
          default: true
          example: true
        seed:
          type: integer
          description: >-
            Random number seed for reproducibility. Identical seeds cannot
            guarantee completely identical results
          minimum: 0
          maximum: 2147483647
          example: 12345
      anyOf:
        - required:
            - prompt
        - required:
            - file_url
        - required:
            - link_url
    AsyncTaskResponse:
      type: object
      required:
        - code
        - message
        - data
      properties:
        code:
          type: integer
          description: Response code, 0 indicates success
          example: 0
        message:
          type: string
          description: Response message
          example: success
        data:
          type: object
          required:
            - status
            - task_id
            - model_id
          properties:
            status:
              type: string
              enum:
                - pending
                - processing
              description: Task status
              example: pending
            task_id:
              type: string
              description: Unique task identifier
              example: task-abc123
            model_id:
              type: string
              description: Model ID
              example: model-123
            get_result:
              type: object
              description: API information to query the task result
              properties:
                method:
                  type: string
                  description: HTTP method
                  example: GET
                url:
                  type: string
                  description: Full URL to query the task result
                  example: https://api.modellix.ai/api/v1/tasks/task-abc123
          description: Detailed data about the submitted asynchronous task.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'API Key authentication. Format: `Bearer YOUR_API_KEY`.'

````