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

# Retrieve Wan video task

> Retrieve a Wan 3.0 or Wan 3.0 Prime task and its video output.

Use the `wan30:` or `wan30prime:` public ID returned by [Create task](https://docs.gengen.farm/api-reference/wan/standard/video-generation/create-task.md), with the API key scope that created it.

```bash theme={"dark"}
curl --url 'https://gengen.farm/api/gengen/v1/contents/generations/tasks/wan30%3A12345678-1234-4234-8234-123456789abc' \
  --header 'Authorization: Bearer gengen_live_xxxxxxxxxxxxxxxx'
```

```json theme={"dark"}
{
  "id": "wan30:12345678-1234-4234-8234-123456789abc",
  "model": "wan-3.0",
  "status": "succeeded",
  "outputs": { "videos": ["https://example.com/output.mp4"], "images": [], "expiresAt": "2026-11-05T08:05:00.000Z" },
  "usage": {
    "priceRowId": "wan-3.0-720p-video",
    "resolution": "720p",
    "outputDurationSeconds": 5.25,
    "inputVideoDurationSeconds": 2.5,
    "billableSeconds": 7.75
  },
  "createdAt": "2026-11-04T08:00:00.000Z"
}
```

Statuses are `pending`, `processing`, `succeeded`, `failed` and `cancelled`.
Pending and failed tasks contain no video output. Terminal failures may include `failureReason`.
When available, `failureReason` contains the specific provider-reported cause, such as an unsupported reference-video codec. The upstream error code, message and supplementary details are preserved, with credentials redacted. If the provider supplies no usable detail, a generic reason is returned. Repeated retrievals retain the saved failure reason.
Successful outputs are returned after wallet settlement. New output links expire 24 hours after generation and cannot be renewed. The response includes `outputs.expiresAt`; download results before that deadline. Task records remain queryable, but expired video URLs are omitted. Historical stored outputs retain their existing renewal behavior.

Repeated polling does not generate a video or charge again. There is no remote task-list operation; use your GENGEN task history.

## Usage

For Wan 3.0 and Wan 3.0 Prime, `usage` on success includes the generated length (`outputDurationSeconds`), the combined reference-video length (`inputVideoDurationSeconds`) and the total used for billing (`billableSeconds`). Durations can include fractional seconds. `resolution` is the pricing tier string. Multiply `billableSeconds` by the per-second rate for this model's `priceRowId` in the [price catalog](https://docs.gengen.farm/api-reference/model-prices).


## OpenAPI

````yaml openapi/wan-standard-video.yaml GET /contents/generations/tasks/{id}
openapi: 3.1.0
info:
  title: Wan Standard Video API
  version: 1.0.0
  description: >-
    Wan 3.0 and Wan 3.0 Prime video generation. Charged by provider-reported
    output seconds plus input reference video seconds, using the frozen customer
    rate.
servers:
  - url: https://gengen.farm/api/gengen/v1
security:
  - bearerAuth: []
paths:
  /contents/generations/tasks/{id}:
    parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
          pattern: ^wan30(prime)?:[0-9a-f-]{36}$
    get:
      summary: Retrieve Wan Standard video task
      operationId: retrieveWanStandardVideoTask
      responses:
        '200':
          description: >-
            Current state. Success is returned after settlement; output links
            expire after 24 hours.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WanTask'
              example:
                id: wan30:12345678-1234-4234-8234-123456789abc
                model: wan-3.0
                status: succeeded
                outputs:
                  videos:
                    - https://example.com/output.mp4
                  images: []
                  expiresAt: '2026-11-05T08:05:00.000Z'
                usage:
                  priceRowId: wan-3.0-720p-video
                  resolution: 720p
                  outputDurationSeconds: 5.25
                  inputVideoDurationSeconds: 2.5
                  billableSeconds: 7.75
        '400':
          description: Invalid request or incompatible media/mode.
        '401':
          description: Invalid API key.
        '402':
          description: Insufficient balance.
        '404':
          description: Task not found in this API key scope.
        '409':
          description: Cancellation is not confirmed or parameters changed during retry.
        '429':
          description: Rate limited.
        '502':
          description: Task outcome could not be confirmed.
        '503':
          description: Generation temporarily unavailable.
components:
  schemas:
    WanTask:
      type: object
      required:
        - id
        - model
        - status
        - outputs
      properties:
        id:
          type: string
          pattern: ^wan30(prime)?:[0-9a-f-]{36}$
        model:
          type: string
          enum:
            - wan-3.0
            - wan-3.0-prime
        status:
          type: string
          enum:
            - pending
            - processing
            - succeeded
            - failed
            - cancelled
        outputs:
          type: object
          required:
            - videos
            - images
          properties:
            videos:
              type: array
              items:
                type: string
                format: uri
            expiresAt:
              type: string
              format: date-time
              description: >-
                Fixed expiration of the output URL. Expired video URLs are
                omitted; they cannot be renewed.
            images:
              type: array
              items:
                type: string
        usage:
          type: object
          description: >-
            Successful task detail. Billable seconds include the generated video
            and all reference video inputs.
          required:
            - priceRowId
            - resolution
            - billableSeconds
            - inputVideoDurationSeconds
            - outputDurationSeconds
          properties:
            priceRowId:
              type: string
              description: Stable customer price row in GET /api/public/pricing.
            resolution:
              type: string
              description: Resolution tier used for pricing, such as 720p.
            billableSeconds:
              type: number
              description: Seconds to multiply by the selected per-second rate.
            inputVideoDurationSeconds:
              type: number
              description: Input video seconds used for billing.
            outputDurationSeconds:
              type: number
              description: Output video duration in seconds.
        createdAt:
          type: string
          format: date-time
        failureReason:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

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