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

# Query video task

> Polls a video generation task. Poll roughly every 15 seconds until status is SUCCESS or FAILURE. The result URL is valid for 24 hours — download it promptly. Quota is auto-refunded on failure.



## OpenAPI

````yaml api-reference/model-api/bytedance/seedance/openapi.yaml GET /v1/video/generations/{task_id}
openapi: 3.1.0
info:
  title: Seedance 2.0 Video Generation
  description: ByteDance Seedance video generation via the Upmore async task API
  version: 1.0.0
servers:
  - url: https://api.upmore.net
security:
  - bearerAuth: []
paths:
  /v1/video/generations/{task_id}:
    get:
      summary: Query video task
      description: >-
        Polls a video generation task. Poll roughly every 15 seconds until
        status is SUCCESS or FAILURE. The result URL is valid for 24 hours —
        download it promptly. Quota is auto-refunded on failure.
      operationId: getSeedanceVideoTask
      parameters:
        - name: task_id
          in: path
          required: true
          schema:
            type: string
          example: asyntask_h81efT0qwtLnzyt6VENmCZ6VXSfNxE2E
          description: Task ID returned by the create endpoint.
      responses:
        '200':
          description: Task state
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: success
                  message:
                    type: string
                  data:
                    type: object
                    properties:
                      task_id:
                        type: string
                        example: asyntask_h81efT0qwtLnzyt6VENmCZ6VXSfNxE2E
                      action:
                        type: string
                        enum:
                          - generate
                          - referenceGenerate
                          - firstTailGenerate
                          - omniGenerate
                        description: Task sub-type.
                      status:
                        type: string
                        enum:
                          - NOT_START
                          - QUEUED
                          - IN_PROGRESS
                          - SUCCESS
                          - FAILURE
                        description: Keep polling until SUCCESS or FAILURE.
                      result_url:
                        type: string
                        description: >-
                          Pre-signed video download URL, valid 24 hours. Omitted
                          on failure.
                      fail_reason:
                        type: string
                        description: Error message on failure.
                      submit_time:
                        type: integer
                        description: Submit timestamp (Unix seconds).
                      start_time:
                        type: integer
                        description: Upstream start timestamp; 0 if not started.
                      finish_time:
                        type: integer
                        description: Finish timestamp.
                      progress:
                        type: string
                        example: 100%
                      request_id:
                        type: string
                      data:
                        type: object
                        description: >-
                          Upstream raw output (video_url, duration, ratio,
                          resolution, fps, seed, usage, ...).
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Task not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````