> ## 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.

# 查询视频任务

> 轮询视频生成任务。建议约 15 秒轮询一次，直到 status 为 SUCCESS 或 FAILURE。结果 URL 有效期 24 小时，请及时下载；失败会自动退回额度。



## OpenAPI

````yaml zh/api-reference/model-api/bytedance/seedance/openapi.yaml GET /v1/video/generations/{task_id}
openapi: 3.1.0
info:
  title: Seedance 2.0 视频生成
  description: 通过 Upmore 异步任务接口调用字节跳动 Seedance 视频生成
  version: 1.0.0
servers:
  - url: https://api.upmore.net
security:
  - bearerAuth: []
paths:
  /v1/video/generations/{task_id}:
    get:
      summary: 查询视频任务
      description: >-
        轮询视频生成任务。建议约 15 秒轮询一次，直到 status 为 SUCCESS 或 FAILURE。结果 URL 有效期 24
        小时，请及时下载；失败会自动退回额度。
      operationId: getSeedanceVideoTask
      parameters:
        - name: task_id
          in: path
          required: true
          schema:
            type: string
          example: asyntask_h81efT0qwtLnzyt6VENmCZ6VXSfNxE2E
          description: 创建接口返回的任务 ID。
      responses:
        '200':
          description: 任务状态
          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: 任务子类型。
                      status:
                        type: string
                        enum:
                          - NOT_START
                          - QUEUED
                          - IN_PROGRESS
                          - SUCCESS
                          - FAILURE
                        description: 持续轮询直到 SUCCESS 或 FAILURE。
                      result_url:
                        type: string
                        description: 预签名视频下载 URL，有效期 24 小时。失败时无此字段。
                      fail_reason:
                        type: string
                        description: 失败时的错误信息。
                      submit_time:
                        type: integer
                        description: 提交时间戳（Unix 秒）。
                      start_time:
                        type: integer
                        description: 上游开始时间戳；未开始为 0。
                      finish_time:
                        type: integer
                        description: 完成时间戳。
                      progress:
                        type: string
                        example: 100%
                      request_id:
                        type: string
                      data:
                        type: object
                        description: >-
                          上游原始输出（video_url、duration、ratio、resolution、fps、seed、usage
                          等）。
        '401':
          description: 未授权
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: 任务不存在
          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

````