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

# Seedance Query Video Generation Task

> Query the status of a video generation task.

> Only supports the last 7 days of task records, time range [T-7 days, T), where T is the UTC timestamp (seconds) of the request. Note: Video URLs are valid for 14 days; please download or save them promptly.



## OpenAPI

````yaml api-reference/en/zmodelVideo/byteplus/seedance-tasks-query.json GET /byteplus/api/v3/contents/generations/tasks/{id}
openapi: 3.0.1
info:
  title: Seedance Query Video Generation Task
  version: 1.0.0
  description: >-
    Query the status of a video generation task.


    > Only supports the last 7 days of task records, time range [T-7 days, T),
    where T is the UTC timestamp (seconds) of the request. Note: Video URLs are
    valid for 14 days; please download or save them promptly.


    ## Authentication


    This interface supports API Key authentication. See Authentication methods
    for details.
servers:
  - url: https://api.powertokens.ai
    description: Baze API server endpoint
security: []
paths:
  /byteplus/api/v3/contents/generations/tasks/{id}:
    get:
      summary: request
      description: >-
        Query the status of a video generation task.


        > Only supports the last 7 days of task records, time range [T-7 days,
        T), where T is the UTC timestamp (seconds) of the request. Note: Video
        URLs are valid for 14 days; please download or save them promptly.
      operationId: querySeedanceVideoTask
      parameters:
        - name: Content-Type
          in: header
          schema:
            type: string
            default: application/json
          description: Request content type.
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: >-
            The ID of the video generation task you need to query.


            > Note: The above parameters are Query String Parameters, passed in
            the URL string.
      responses:
        '200':
          description: Submission successful, returns video task object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VideoTaskResponse'
        '400':
          description: Invalid request parameters.
        '401':
          description: Authentication failed.
        '429':
          description: Request rate limit exceeded.
        '500':
          description: Internal server error.
      security:
        - BearerAuth: []
components:
  schemas:
    VideoTaskResponse:
      type: object
      properties:
        id:
          type: string
          description: >-
            Video generation task ID. Only stored for 7 days (from the
            `created_at` timestamp), then automatically deleted.


            * When draft: true, this is the Draft video task ID.

            * When draft: false, this is the normal video task ID.


            Video generation is asynchronous. After obtaining the ID, use the
            query video generation task API to check the status. When
            successful, the API returns the generated video URL.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'Pass `Authorization: Bearer <token>` in the request header.'

````