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

# Query Task Result

> Query task result by task ID

This is the **Wan 3.0 Video Generation API** query task result endpoint. Query video generation status and results by task ID.


## OpenAPI

````yaml openapi/en/wan-task-result.json GET /wan/api/v1/tasks/{task_id}
openapi: 3.1.0
info:
  title: Wan 3.0 - Query Task Result DOCS
  version: 1.0.0
  description: >-
    Wan 3.0 Query Task Result API - Query video generation status and results by
    task ID.
servers:
  - url: https://api.ttapi.io
security: []
paths:
  /wan/api/v1/tasks/{task_id}:
    get:
      description: Query task result by task ID
      parameters:
        - name: task_id
          in: path
          required: true
          description: Task ID
          schema:
            type: string
      responses:
        '200':
          description: Query task result successful
          content:
            application/json:
              schema:
                type: object
                properties:
                  request_id:
                    type: string
                    description: >-
                      Unique request identifier. Can be used for request tracing
                      and troubleshooting.
                    example: 78c9b768-0285-996c-b682-xxxxxx
                  output:
                    type: object
                    description: Task output information
                    properties:
                      task_id:
                        type: string
                        description: Task ID
                        example: 17ed7e50-00cf-4509-aea1-xxxxxx
                      task_status:
                        type: string
                        description: Task status
                        enum:
                          - PENDING
                          - RUNNING
                          - SUCCEEDED
                          - FAILED
                          - CANCELED
                          - UNKNOWN
                        example: SUCCEEDED
                      submit_time:
                        type: string
                        description: >-
                          Task submission time. Timezone is UTC+8, format is
                          YYYY-MM-DD HH:mm:ss.SSS.
                        example: '2026-08-06 10:01:35.452'
                      scheduled_time:
                        type: string
                        description: >-
                          Task execution time. Timezone is UTC+8, format is
                          YYYY-MM-DD HH:mm:ss.SSS.
                        example: '2026-08-06 10:01:35.507'
                      end_time:
                        type: string
                        description: >-
                          Task completion time. Timezone is UTC+8, format is
                          YYYY-MM-DD HH:mm:ss.SSS.
                        example: '2026-08-06 10:13:33.838'
                      orig_prompt:
                        type: string
                        description: Original input prompt.
                        example: >-
                          A golden retriever running on a sunny beach, waves
                          crashing in the background.
                      video_url:
                        type: string
                        description: >-
                          Generated video URL. Returned when task succeeds.
                          Video URL is only retained for 24 hours and will be
                          automatically cleared after expiration. Please save
                          the generated video promptly.
                        example: >-
                          https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxxx.mp4
                    required:
                      - task_id
                      - task_status
                  usage:
                    type: object
                    description: Output statistics. Only counts successful results.
                    properties:
                      video_count:
                        type: integer
                        description: Number of generated videos. Fixed at 1.
                        example: 1
                      duration:
                        type: number
                        description: Duration of generated video in seconds.
                        example: 5
                      input_video_duration:
                        type: number
                        description: >-
                          Duration of input video in seconds. 0.0 when no video
                          input.
                        example: 0
                      output_video_duration:
                        type: number
                        description: Duration of output video in seconds.
                        example: 5
                      fps:
                        type: integer
                        description: Frame rate of generated video. Default is 30.
                        example: 30
                      SR:
                        type: integer
                        description: 'Resolution of generated video. Example value: 720.'
                        example: 720
                      ratio:
                        type: string
                        description: 'Aspect ratio of generated video. Example value: 16:9.'
                        example: '16:9'
                required:
                  - request_id
                  - output
      security:
        - CustomApiKey: []
components:
  securitySchemes:
    CustomApiKey:
      type: apiKey
      in: header
      name: TT-API-KEY
      description: >-
        Please visit <a href='https://dashboard.ttapi.io' target='_blank'>TTAPI
        Dashboard</a> to get your API key.

````