Skip to main content

Wan - Text to Video

High-quality video generation from text descriptions powered by Wan’s advanced AI model

Query Task Status

After submitting a task, use the unified query endpoint to check progress and retrieve results:

Get Task Details

Learn how to query task status and retrieve generation results
For production use, we recommend using the callBackUrl parameter to receive automatic notifications when generation completes, rather than polling the status endpoint.
Rate limits and quotas are enforced by Apikley and may differ from upstream providers.

OpenAPI

market/wan/2-2-a14b-text-to-video-turbo.json post /api/v1/jobs/createTask
openapi: 3.0.0
info:
  title: Wan API
  description: Apikley Wan API Documentation - Text to Video
  version: 1.0.0
  contact:
    name: Technical Support
    email: [email protected]
servers:
  - url: https://api.apikley.ru
    description: API Server
security:
  - BearerAuth: []
paths:
  /api/v1/jobs/createTask:
    post:
      summary: Generate videos from text using wan/2-2-a14b-text-to-video-turbo
      operationId: wan-2-2-a14b-text-to-video-turbo
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - model
              properties:
                model:
                  type: string
                  enum:
                    - wan/2-2-a14b-text-to-video-turbo
                  default: wan/2-2-a14b-text-to-video-turbo
                  description: >-
                    The model name to use for generation. Required field.


                    - Must be `wan/2-2-a14b-text-to-video-turbo` for this
                    endpoint
                  example: wan/2-2-a14b-text-to-video-turbo
                callBackUrl:
                  type: string
                  format: uri
                  description: >-
                    The URL to receive generation task completion updates.
                    Optional but recommended for production use.


                    - System will POST task status and results to this URL when
                    generation completes

                    - Callback includes generated content URLs and task
                    information

                    - Your callback endpoint should accept POST requests with
                    JSON payload containing results

                    - Alternatively, use the Get Task Details endpoint to poll
                    task status
                  example: https://your-domain.com/api/callback
                input:
                  type: object
                  description: Input parameters for the generation task
                  properties:
                    prompt:
                      description: >-
                        The text prompt to guide video generation. (Max length:
                        5000 characters)
                      type: string
                      maxLength: 5000
                      example: >-
                        Drone shot, fast traversal, starting inside a cracked,
                        frosty circular pipe. The camera bursts upward through
                        the pipe to reveal a vast polar landscape bathed in
                        golden sunrise light. Workers in orange suits operate
                        steaming machinery. The camera tilts up, revealing the
                        scene from the perspective of a rising hot air balloon.
                        It continues ascending into a glowing sky, the balloon
                        trailing steam and displaying the letters "APIKLEY" as it
                        rises into breathtaking polar majesty.
                    resolution:
                      description: >-
                        Resolution of the generated video (480p, 580p, or 720p).
                        Default value: "720p"
                      type: string
                      enum:
                        - 480p
                        - 580p
                        - 720p
                      default: 720p
                      example: 720p
                    aspect_ratio:
                      description: >-
                        Aspect ratio of the generated video (16:9 or 9:16).
                        Default value: "16:9"
                      type: string
                      enum:
                        - '16:9'
                        - '9:16'
                        - '1:1'
                      default: '16:9'
                      example: '16:9'
                    enable_prompt_expansion:
                      description: >-
                        Whether to enable prompt expansion. This will use a
                        large language model to expand the prompt with
                        additional details while maintaining the original
                        meaning. (Boolean value (true/false))
                      type: boolean
                      example: false
                    seed:
                      description: >-
                        Random seed for reproducibility. If None, a random seed
                        is chosen. (Min: 0, Max: 2147483647, Step: 1) (step: 1)
                      type: number
                      minimum: 0
                      maximum: 2147483647
                      default: 0
                      example: 0
                    acceleration:
                      description: >-
                        Acceleration level to use. The more acceleration, the
                        faster the generation, but with lower quality. The
                        recommended value is 'none'. Default value: "none"
                      type: string
                      enum:
                        - none
                        - regular
                      default: none
                      example: none
                  required:
                    - prompt
            example:
              model: wan/2-2-a14b-text-to-video-turbo
              callBackUrl: https://your-domain.com/api/callback
              input:
                prompt: >-
                  Drone shot, fast traversal, starting inside a cracked, frosty
                  circular pipe. The camera bursts upward through the pipe to
                  reveal a vast polar landscape bathed in golden sunrise light.
                  Workers in orange suits operate steaming machinery. The camera
                  tilts up, revealing the scene from the perspective of a rising
                  hot air balloon. It continues ascending into a glowing sky,
                  the balloon trailing steam and displaying the letters "APIKLEY"
                  as it rises into breathtaking polar majesty.
                resolution: 720p
                aspect_ratio: '16:9'
                enable_prompt_expansion: false
                seed: 0
                acceleration: none
      responses:
        '200':
          description: Request successful
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ApiResponse'
                  - type: object
                    properties:
                      data:
                        type: object
                        properties:
                          taskId:
                            type: string
                            description: >-
                              Task ID, can be used with Get Task Details
                              endpoint to query task status
                            example: task_wan_1765172502514
              example:
                code: 200
                msg: success
                data:
                  taskId: task_wan_1765172502514
        '500':
          $ref: '#/components/responses/Error'
components:
  schemas:
    ApiResponse:
      type: object
      properties:
        code:
          type: integer
          enum:
            - 200
            - 401
            - 402
            - 404
            - 422
            - 429
            - 455
            - 500
            - 501
            - 505
          description: >-
            Response status code


            - **200**: Success - Request has been processed successfully

            - **401**: Unauthorized - Authentication credentials are missing or
            invalid

            - **402**: Insufficient Credits - Account does not have enough
            credits to perform the operation

            - **404**: Not Found - The requested resource or endpoint does not
            exist

            - **422**: Validation Error - The request parameters failed
            validation checks

            - **429**: Rate Limited - Request limit has been exceeded for this
            resource

            - **455**: Service Unavailable - System is currently undergoing
            maintenance

            - **500**: Server Error - An unexpected error occurred while
            processing the request

            - **501**: Generation Failed - Content generation task failed

            - **505**: Feature Disabled - The requested feature is currently
            disabled
        msg:
          type: string
          description: Response message, error description when failed
          example: success
  responses:
    Error:
      description: Server Error
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        All APIs require authentication via Bearer Token.


        Get API Key:

        1. Visit [API Key Management Page](https://app.apikley.ru/keys) to get your
        API Key


        Usage:

        Add to request header:

        Authorization: Bearer APIKLEY_API_KEY


        Note:

        - Keep your API Key secure and do not share it with others

        - If you suspect your API Key has been compromised, reset it immediately
        in the management page


To find navigation and other pages in this documentation, fetch the llms.txt file at: https://docs.apikley.ru/llms.txt