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

# Alibaba W3.0-Prime Video Generation Task

> Retrieve the status and result of a generation task

## Overview

Retrieve the status and result of a `w3.0-video-prime` generation task.

## Task Status

| Status | Description |
| :- | :- |
| `pending` | Task is waiting to be processed |
| `processing` | Task is currently being processed |
| `completed` | Task completed successfully |
| `failed` | Task failed with an error |

## Response

When the task is completed the response includes:

* `videos` — the generated video URLs

## Example Response

### Completed Task

```json theme={null}
{
  "task_info": {
    "id": "95c457ab-6ea4-4cd9-af18-6f42cdc88411",
    "status": "completed",
    "created_at": "2026-08-21T00:00:00Z",
    "updated_at": "2026-08-21T00:03:00Z"
  },
  "videos": [
    "https://mulerouter.muleusercontent.com/public/95c457ab-6ea4-4cd9-af18-6f42cdc88411/result_000.mp4"
  ]
}
```

### Failed Task

```json theme={null}
{
  "task_info": {
    "id": "95c457ab-6ea4-4cd9-af18-6f42cdc88411",
    "status": "failed",
    "created_at": "2026-08-21T00:00:00Z",
    "updated_at": "2026-08-21T00:00:15Z",
    "error": {
      "code": 400,
      "title": "Invalid Request",
      "detail": "cannot mix the reference mode (reference_images / reference_videos / reference_audios) with the keyframe mode (first_frame / last_frame)"
    }
  }
}
```


## OpenAPI

````yaml api-reference/endpoint/alibaba/w3.0-video-prime/w3.0-video-prime.yaml GET /vendors/alibaba/v1/w3.0-video-prime/generation/{task_id}
openapi: 3.1.0
info:
  title: Alibaba W3.0-Prime Video Generation API
  description: >-
    Generate videos with the W3.0-Prime all-in-one model (Alibaba Wan 3.0
    Prime). This is the faster tier of `w3.0-video`: the request contract is
    identical

    field for field, the only differences being faster turnaround and a higher
    per-second price.


    A single `generation` endpoint covers three capability sets — the media
    fields you send decide which one runs:


    - Text-to-video: `prompt` only, no media fields.

    - Image-to-video (keyframe mode): `first_frame` and/or `last_frame`.

    - Reference-to-video (reference mode): `reference_images` /
    `reference_videos` / `reference_audios` / `file` / `link`.


    Keyframe mode and reference mode are mutually exclusive — a single request
    cannot mix fields from both.


    In reference mode the `prompt` may refer to inputs by index ("Image 1" /
    "Video 1"),

    counted separately per field in array order.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.mulerouter.ai/
security:
  - bearerAuth: []
paths:
  /vendors/alibaba/v1/w3.0-video-prime/generation/{task_id}:
    get:
      summary: Get Generation Task
      description: Retrieve the status and result of a generation task
      operationId: alibaba_w3_0_video_prime_generation_get
      parameters:
        - name: task_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Task result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/W30VideoPrimeResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    W30VideoPrimeResponse:
      type: object
      additionalProperties: true
      properties:
        task_info:
          $ref: '#/components/schemas/TaskInfoResponse'
        videos:
          type: array
          description: Generated video URLs (only present when status is completed).
          items:
            type: string
            format: uri
    ErrorResponse:
      type: object
      additionalProperties: true
      properties:
        task_info:
          $ref: '#/components/schemas/TaskInfoErrorResponse'
    TaskInfoResponse:
      type: object
      additionalProperties: true
      properties:
        id:
          type: string
          description: UUID of the task
          format: uuid
        status:
          type: string
          description: Task status
          enum:
            - completed
            - pending
            - processing
            - failed
        created_at:
          type: string
          description: Task creation timestamp (ISO 8601)
          format: date-time
        updated_at:
          type: string
          description: Task last update timestamp (ISO 8601)
          format: date-time
      required:
        - id
        - status
        - created_at
        - updated_at
    TaskInfoErrorResponse:
      type: object
      additionalProperties: true
      properties:
        id:
          type: string
          description: UUID of the task
          format: uuid
        status:
          type: string
          description: Task status (always failed for error responses)
          enum:
            - failed
        created_at:
          type: string
          description: Task creation timestamp (ISO 8601)
          format: date-time
        updated_at:
          type: string
          description: Task last update timestamp (ISO 8601)
          format: date-time
        error:
          $ref: '#/components/schemas/TaskInfoErrorObject'
      required:
        - id
        - status
        - created_at
        - updated_at
        - error
    TaskInfoErrorObject:
      type: object
      additionalProperties: true
      properties:
        code:
          type: integer
          description: MuleRouter Error code
          example: 2001
        title:
          type: string
          description: MuleRouter Error title
          example: Invalid Request
        detail:
          type: string
          description: MuleRouter Error detail
          example: >-
            cannot mix the reference mode (reference_images / reference_videos /
            reference_audios) with the keyframe mode (first_frame / last_frame)
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

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