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

# Wan3.0 Text-to-Video

> - Generates video from `prompt` only, **no media input is accepted**
- Videos of up to **30 seconds**, `duration: -1` smart duration supported
- For first-and-last-frame control use [Wan3.0 Image-to-Video](/en/api-manual/video-series/wan3.0/wan3.0-image-to-video); for reference material use [Wan3.0 Reference-to-Video](/en/api-manual/video-series/wan3.0/wan3.0-reference-video)
- Asynchronous processing mode, use the returned task ID to [query status](/en/api-manual/task-management/get-task-detail)
- Generated video links are valid for 24 hours, please save them promptly

## Billing

- **Billing formula**: billed duration = input video duration + output video duration, billed per second
- **Resolution multiplier**: `480p` = 1x (baseline), `720p` = 2x, `1080p` = 4x
- Reference images, reference audio, reference files and web page links are **not billed**
- When `duration` is `-1` (smart duration), credits are pre-authorized at the `30`-second cap; once the task succeeds it is settled against the actual output duration and the difference is refunded automatically
- Turning the `audio` track on or off **costs the same**
- **Failed tasks are not billed**, the frozen credits are refunded in full



## OpenAPI

````yaml en/api-manual/video-series/wan3.0/wan3.0-text-to-video.json POST /v1/videos/generations
openapi: 3.1.0
info:
  title: Wan3.0 Text-to-Video API
  description: >-
    Wan 3.0 text-to-video, generating videos of up to 30 seconds from a text
    prompt alone
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.evolink.ai
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Video Generation
    description: AI video generation endpoints
paths:
  /v1/videos/generations:
    post:
      tags:
        - Video Generation
      summary: Wan3.0 Text-to-Video
      description: >-
        - Generates video from `prompt` only, **no media input is accepted**

        - Videos of up to **30 seconds**, `duration: -1` smart duration
        supported

        - For first-and-last-frame control use [Wan3.0
        Image-to-Video](/en/api-manual/video-series/wan3.0/wan3.0-image-to-video);
        for reference material use [Wan3.0
        Reference-to-Video](/en/api-manual/video-series/wan3.0/wan3.0-reference-video)

        - Asynchronous processing mode, use the returned task ID to [query
        status](/en/api-manual/task-management/get-task-detail)

        - Generated video links are valid for 24 hours, please save them
        promptly


        ## Billing


        - **Billing formula**: billed duration = input video duration + output
        video duration, billed per second

        - **Resolution multiplier**: `480p` = 1x (baseline), `720p` = 2x,
        `1080p` = 4x

        - Reference images, reference audio, reference files and web page links
        are **not billed**

        - When `duration` is `-1` (smart duration), credits are pre-authorized
        at the `30`-second cap; once the task succeeds it is settled against the
        actual output duration and the difference is refunded automatically

        - Turning the `audio` track on or off **costs the same**

        - **Failed tasks are not billed**, the frozen credits are refunded in
        full
      operationId: createWan30TextToVideo
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VideoGenerationRequest'
            examples:
              basic:
                summary: Basic text-to-video
                value:
                  model: wan3.0-text-to-video
                  prompt: >-
                    A kitten runs across a rooftop in the moonlight, city neon
                    flickers in the distance, cinematic quality, smooth camera
                    work.
                  duration: 5
                  quality: 720p
                  aspect_ratio: '16:9'
                  generate_audio: true
              smart_duration:
                summary: Smart duration + 1080p
                value:
                  model: wan3.0-text-to-video
                  prompt: >-
                    A high-end smart glasses product ad, minimalist and
                    futuristic, the camera glides over the lens and hinge
                    details and finally settles on the brand logo.
                  duration: -1
                  quality: 1080p
                  aspect_ratio: '16:9'
              silent:
                summary: Silent video
                value:
                  model: wan3.0-text-to-video
                  prompt: >-
                    An aerial shot sweeps over snow-capped mountains at dawn, a
                    sea of clouds drifting slowly through the valleys.
                  duration: 8
                  quality: 480p
                  generate_audio: false
      responses:
        '200':
          description: Video generation task created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VideoGenerationResponse'
        '400':
          description: Invalid request parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: invalid_parameter
                  message: Invalid request parameters
                  type: invalid_request_error
        '401':
          description: Unauthenticated, invalid or expired token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: unauthorized
                  message: Invalid or expired token
                  type: authentication_error
        '402':
          description: Insufficient quota, recharge required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: insufficient_quota
                  message: Insufficient quota. Please top up your account.
                  type: insufficient_quota
        '403':
          description: Access denied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: model_access_denied
                  message: 'Token does not have access to model: wan3.0-text-to-video'
                  type: invalid_request_error
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: rate_limit_exceeded
                  message: Too many requests, please try again later
                  type: rate_limit_error
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: internal_error
                  message: Internal server error
                  type: api_error
components:
  schemas:
    VideoGenerationRequest:
      type: object
      required:
        - model
        - prompt
      properties:
        model:
          type: string
          description: Model name, fixed to `wan3.0-text-to-video`
          enum:
            - wan3.0-text-to-video
          example: wan3.0-text-to-video
          default: wan3.0-text-to-video
        prompt:
          type: string
          description: >-
            Text prompt for video generation. Chinese and English are supported,
            **each Chinese character / letter counts as 1 character**, maximum
            length `20000` characters; anything beyond that is truncated
            automatically (no error)


            **Note:** this model is pure text-to-video and accepts no media
            input.
          example: >-
            A kitten runs across a rooftop in the moonlight, city neon flickers
            in the distance, cinematic quality, smooth camera work.
        duration:
          type: integer
          description: >-
            Duration of the generated video in seconds, defaults to `5`


            **Accepted values:**

            - Any integer between `2` and `30`

            - `-1`: smart duration, the model decides the output length from the
            prompt and the input material


            **How smart duration is billed:** the output length cannot be known
            at submission time, so credits are pre-authorized at the `30`-second
            **cap**; once the task succeeds it is settled against the actual
            output duration and the excess hold is released automatically. If
            your balance cannot cover the capped hold, pass an explicit number
            of seconds instead.
          default: 5
          example: 5
        quality:
          type: string
          description: >-
            Video resolution, defaults to `720p`


            **Options:**

            - `480p`: lower definition, lowest price (billing baseline)

            - `720p`: standard definition, this is the default, 2x the price of
            `480p`

            - `1080p`: high definition, 4x the price of `480p`
          enum:
            - 480p
            - 720p
            - 1080p
          default: 720p
          example: 720p
        aspect_ratio:
          type: string
          description: >-
            Video aspect ratio, defaults to `adaptive`


            **Options:**

            - `adaptive`: adaptive, the model recommends a suitable aspect ratio
            based on the input material's ratio and the intent of the prompt,
            this is the default

            - `16:9` (landscape), `9:16` (portrait), `1:1` (square), `4:3`,
            `3:4`
          enum:
            - adaptive
            - '16:9'
            - '9:16'
            - '1:1'
            - '4:3'
            - '3:4'
          default: adaptive
          example: '16:9'
        generate_audio:
          type: boolean
          description: >-
            Whether the output video contains an audio track, defaults to `true`


            **Options:**

            - `true`: the output video contains sound (voices, sound effects,
            background music), this is the default

            - `false`: silent video output


            **Sound on and sound off cost the same**, there is no extra charge.
          default: true
          example: true
        seed:
          type: integer
          description: >-
            Random seed, used to reproduce generation results, random by default


            **Notes:**

            - Range: `0` ~ `2147483647`

            - Fixing the seed reduces variation when iterating on prompts and
            improves reproducibility
          minimum: 0
          maximum: 2147483647
          example: 42
        callback_url:
          type: string
          description: >-
            HTTPS callback URL for task completion


            **Callback timing:**

            - Triggered when the task is completed, failed, or cancelled

            - Sent after billing confirmation is complete


            **Security restrictions:**

            - Only HTTPS protocol is supported

            - Callbacks to private IP addresses are prohibited (127.0.0.1,
            10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)

            - URL length must not exceed `2048` characters


            **Callback mechanism:**

            - Timeout: `10` seconds

            - Up to `3` retries after failure (at `1`/`2`/`4` seconds after
            failure respectively)

            - Callback response body format is consistent with the task query
            endpoint response format

            - A 2xx status code is considered successful; other status codes
            trigger retries
          format: uri
          example: https://your-domain.com/webhooks/video-task-completed
    VideoGenerationResponse:
      type: object
      properties:
        created:
          type: integer
          description: Task creation timestamp
          example: 1761313744
        id:
          type: string
          description: Task ID
          example: task-unified-1774857405-abc123
        model:
          type: string
          description: Actual model name used
          example: wan3.0-text-to-video
        object:
          type: string
          enum:
            - video.generation.task
          description: Specific task type
        progress:
          type: integer
          description: Task progress percentage (0-100)
          minimum: 0
          maximum: 100
          example: 0
        status:
          type: string
          description: Task status
          enum:
            - pending
            - processing
            - completed
            - failed
          example: pending
        task_info:
          $ref: '#/components/schemas/VideoTaskInfo'
          description: Video task details
        type:
          type: string
          enum:
            - text
            - image
            - audio
            - video
          description: Task output type
          example: video
        usage:
          $ref: '#/components/schemas/VideoUsage'
          description: Usage and billing information
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              description: Error code identifier
            message:
              type: string
              description: Error description
            type:
              type: string
              description: Error type
    VideoTaskInfo:
      type: object
      properties:
        can_cancel:
          type: boolean
          description: Whether the task can be cancelled
          example: true
        estimated_time:
          type: integer
          description: Estimated completion time (seconds)
          minimum: 0
          example: 165
        video_duration:
          type: integer
          description: Video duration (seconds)
          example: 8
    VideoUsage:
      type: object
      description: Usage and billing information
      properties:
        billing_rule:
          type: string
          description: Billing rule
          enum:
            - per_call
            - per_token
            - per_second
          example: per_second
        credits_reserved:
          type: number
          description: Estimated credits consumed
          minimum: 0
          example: 50
        user_group:
          type: string
          description: User group category
          example: default
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        ##All endpoints require Bearer Token authentication##


        **Get API Key:**


        Visit the [API Key Management Page](https://evolink.ai/dashboard/keys)
        to obtain your API Key


        **Add to request header:**

        ```

        Authorization: Bearer YOUR_API_KEY

        ```

````