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

# Create video

> Wan (Tongyi Wanxiang) async video create.

**Path:** `POST https://api.omniall.ai/v1/video/generations`

Also `POST /v1/videos`. Poll with returned `id` / `task_id`.

Currently supported models (Alibaba Wan): `wan2.1-480P`, `wan2.1-720P`, `wan2.1-1080P` (see [Model Square](https://omniall.ai/pricing)).

Auth: `Authorization: Bearer sk-...`



## OpenAPI

````yaml openapi/wan-video.yaml POST /v1/video/generations
openapi: 3.1.0
info:
  title: Omniall AI — Wan video
  version: 1.0.0
  description: >-
    Wan (Tongyi Wanxiang) async video create.


    **Path:** `POST https://api.omniall.ai/v1/video/generations`


    Also `POST /v1/videos`. Poll with returned `id` / `task_id`.


    Currently supported models (Alibaba Wan): `wan2.1-480P`, `wan2.1-720P`,
    `wan2.1-1080P` (see [Model Square](https://omniall.ai/pricing)).


    Auth: `Authorization: Bearer sk-...`
servers:
  - url: https://api.omniall.ai
security: []
paths:
  /v1/video/generations:
    post:
      tags:
        - Wan
      summary: Create video
      description: >-
        Wan (Tongyi Wanxiang) async video create.


        **Path:** `POST https://api.omniall.ai/v1/video/generations`


        Also `POST /v1/videos`. Poll with returned `id` / `task_id`.


        Currently supported models (Alibaba Wan): `wan2.1-480P`, `wan2.1-720P`,
        `wan2.1-1080P` (see [Model Square](https://omniall.ai/pricing)).


        Auth: `Authorization: Bearer sk-...`
      operationId: wanCreateVideo
      parameters:
        - name: Authorization
          in: header
          required: true
          schema:
            type: string
            example: Bearer sk-...
          description: Bearer API key, e.g. `Bearer sk-...`.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - model
                - prompt
              description: Wan / Tongyi Wanxiang async create body.
              properties:
                model:
                  type: string
                  description: >-
                    Video model id. Currently supported models (Alibaba Wan):
                    `wan2.1-480P`, `wan2.1-720P`, `wan2.1-1080P` (see [Model
                    Square](https://omniall.ai/pricing)).
                  example: wan2.1-720P
                prompt:
                  type: string
                  description: Text prompt.
                  example: >-
                    Cinematic city night, slow push along a wet street, neon
                    reflections
                duration:
                  type: integer
                  description: 'Duration in seconds. Alias: `seconds`.'
                  example: 10
                seconds:
                  type: string
                ratio:
                  type: string
                  enum:
                    - '21:9'
                    - '16:9'
                    - '4:3'
                    - '1:1'
                    - '3:4'
                    - '9:16'
                  description: 'Aspect ratio. Aliases: `size`, `aspect_ratio`.'
                  example: '16:9'
                size:
                  type: string
                aspect_ratio:
                  type: string
                images:
                  type: array
                  items:
                    type: string
                  description: Multi-image references.
                image:
                  type: string
                first_frame:
                  oneOf:
                    - type: string
                    - type: array
                      items:
                        type: string
                  description: First frame URL(s).
                last_frame:
                  oneOf:
                    - type: string
                    - type: array
                      items:
                        type: string
                  description: Last frame URL(s).
                start_frame:
                  oneOf:
                    - type: string
                    - type: array
                      items:
                        type: string
                end_frame:
                  oneOf:
                    - type: string
                    - type: array
                      items:
                        type: string
                reference_images:
                  type: array
                  items:
                    type: string
                reference_videos:
                  type: array
                  items:
                    type: string
                reference_audios:
                  type: array
                  items:
                    type: string
                generate_audio:
                  type: boolean
                  example: true
                content:
                  type: array
                  items:
                    type: object
                    additionalProperties: true
            examples:
              text_to_video:
                summary: Text-to-video
                value:
                  model: wan2.1-720P
                  prompt: >-
                    Cinematic city night, slow push along a wet street, neon
                    reflections on the road
                  duration: 10
                  ratio: '16:9'
                  generate_audio: true
              multi_image_reference:
                summary: Multi-image reference
                value:
                  model: wan2.1-720P
                  prompt: >-
                    Keep character look from these images; generate a
                    turn-and-walk shot
                  duration: 5
                  ratio: '16:9'
                  images:
                    - https://example.com/character-front.jpg
                    - https://example.com/character-side.jpg
                  generate_audio: true
              omni_multimodal:
                summary: Omni multimodal reference
                value:
                  model: wan2.1-1080P
                  prompt: >-
                    Keep product look; follow camera from video; sync rhythm to
                    audio
                  duration: 8
                  ratio: '16:9'
                  reference_images:
                    - https://example.com/product.png
                  reference_videos:
                    - https://example.com/motion-guide.mp4
                  reference_audios:
                    - https://example.com/music-guide.mp3
                  generate_audio: true
              first_last_frame:
                summary: First & last frame
                value:
                  model: wan2.1-720P
                  prompt: From morning to dusk, clouds drift, light transitions
                  duration: 5
                  ratio: '16:9'
                  first_frame: https://example.com/morning.png
                  last_frame: https://example.com/dusk.png
              first_last_frame_v2:
                summary: First & last frame · arrays
                value:
                  model: wan2.1-720P
                  prompt: From morning to dusk, clouds drift
                  duration: 5
                  ratio: '16:9'
                  start_frame:
                    - https://example.com/morning.png
                  end_frame:
                    - https://example.com/dusk.png
              first_last_frame_v3:
                summary: First & last frame · content roles
                value:
                  model: wan2.1-720P
                  prompt: Clouds drift, light transitions
                  duration: 5
                  ratio: '16:9'
                  content:
                    - type: image_url
                      url: https://example.com/morning.png
                      role: first_frame
                    - type: image_url
                      url: https://example.com/dusk.png
                      role: last_frame
      responses:
        '200':
          description: Accepted
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  task_id:
                    type: string
                  status:
                    type: string
                  created_at:
                    type: integer
              example:
                id: task_xxx
                task_id: task_xxx
                status: submitted
        '400':
          description: Bad request
        '401':
          description: Unauthorized

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.