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

# 列出视频任务 · Ark

> 按时间倒序列出最近 7 天的任务，支持分页和状态过滤。

`GET /v1/contents/generations/tasks?page_num=1&page_size=20` 列出最近 7 天的任务，支持 `filter.status`、`filter.model` 和 `filter.task_ids` 过滤。

列表中的任务对象与 [查询单个任务](/cn/api/video-ark-get) 相同。


## OpenAPI

````yaml openapi/relay.json GET /v1/contents/generations/tasks
openapi: 3.0.1
info:
  title: AIOHub API
  description: AIOHub 公开 API
  version: 1.0.0
servers:
  - url: https://api.aiohub.org
security:
  - BearerAuth: []
tags:
  - name: 获取模型列表
  - name: OpenAI Chat
  - name: OpenAI Responses
  - name: 图片生成
  - name: OpenAI 图像
  - name: 视频生成
  - name: Claude Messages
  - name: Gemini API
  - name: OpenAI Embeddings
  - name: 文本补全
  - name: OpenAI 音频
  - name: Realtime API
paths:
  /v1/contents/generations/tasks:
    get:
      tags:
        - 视频生成
      summary: 列出视频任务
      description: |
        按时间倒序返回当前 API 令牌所属账号最近 7 天内的视频任务，条目结构与查询单个任务相同。
      operationId: listSeedanceVideoTasks
      parameters:
        - name: page_num
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 500
            default: 1
          description: 页码
        - name: page_size
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 500
            default: 20
          description: 每页条数
        - name: filter.status
          in: query
          required: false
          schema:
            type: string
            enum:
              - queued
              - running
              - succeeded
              - failed
              - cancelled
              - expired
          description: 按状态过滤
        - name: filter.model
          in: query
          required: false
          schema:
            type: string
          example: doubao-seedance-2-5-260628
          description: 按模型过滤
        - name: filter.task_ids
          in: query
          required: false
          schema:
            type: array
            items:
              type: string
          style: form
          explode: true
          description: 按任务 ID 过滤，可重复
      responses:
        '200':
          description: 任务列表
          headers: {}
          content:
            application/json:
              schema:
                type: object
                properties:
                  total:
                    type: integer
                    description: 符合条件的任务总数
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/SeedanceTask'
              example:
                total: 1
                items:
                  - id: task_ADQ5XK6AKWg36WePoJ3sZRyDvWl1ogGZ
                    model: doubao-seedance-2-5-260628
                    status: succeeded
                    error: null
                    content:
                      video_url: >-
                        https://api.aiohub.org/v1/videos/task_ADQ5XK6AKWg36WePoJ3sZRyDvWl1ogGZ/content
                    usage:
                      completion_tokens: 87300
                      total_tokens: 87300
                    output_format: mp4
                    framespersecond: 24
                    resolution: 720p
                    ratio: '16:9'
                    duration: 4
                    generate_audio: true
                    priority: 0
                    service_tier: default
                    execution_expires_after: 172800
                    created_at: 1791275108
                    updated_at: 1791275315
        '401':
          description: API 令牌缺失或无效
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          headers: {}
      deprecated: false
      security:
        - BearerAuth: []
components:
  schemas:
    SeedanceTask:
      type: object
      description: 视频任务对象。
      properties:
        id:
          type: string
          description: 任务 ID
          example: task_ADQ5XK6AKWg36WePoJ3sZRyDvWl1ogGZ
        model:
          type: string
          example: doubao-seedance-2-5-260628
        status:
          type: string
          enum:
            - queued
            - running
            - succeeded
            - failed
            - cancelled
            - expired
          description: 任务状态
        error:
          nullable: true
          allOf:
            - $ref: '#/components/schemas/SeedanceTaskError'
          description: 任务未成功时的错误，成功时为 `null`。
        content:
          type: object
          nullable: true
          description: 状态为 `succeeded` 时的产物地址，下载时携带同一个 API 令牌。
          properties:
            video_url:
              type: string
              example: >-
                https://api.aiohub.org/v1/videos/task_ADQ5XK6AKWg36WePoJ3sZRyDvWl1ogGZ/content
            last_frame_url:
              type: string
              description: '仅在创建任务时设置了 `return_last_frame: true` 才返回。'
        usage:
          type: object
          properties:
            completion_tokens:
              type: integer
              description: 已交付视频的计费 token 数，计算方式见 [视频模型与计费](/cn/api/video-models#计费)。
            total_tokens:
              type: integer
        output_format:
          type: string
          example: mp4
        framespersecond:
          type: integer
          example: 24
        resolution:
          type: string
          description: 运行中为请求值，成功后为实际交付值。
        ratio:
          type: string
          description: 运行中为请求值，成功后为实际交付值。
        duration:
          type: integer
          description: 运行中为请求值，成功后为实际交付值。
        generate_audio:
          type: boolean
        priority:
          type: integer
        service_tier:
          type: string
          example: default
        execution_expires_after:
          type: integer
          example: 172800
        safety_identifier:
          type: string
        created_at:
          type: integer
          description: 创建时间（Unix 秒）
        updated_at:
          type: integer
          description: 最近更新时间（Unix 秒）
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
              description: 错误信息
            type:
              type: string
              description: 错误类型
            param:
              type: string
              description: 相关参数
              nullable: true
            code:
              type: string
              description: 错误代码
              nullable: true
    SeedanceTaskError:
      type: object
      description: 视频任务接口的错误响应。
      properties:
        code:
          type: string
          description: 错误码
          example: invalid_duration
        message:
          type: string
          description: 错误信息
          example: duration must be between 4 and 30 seconds for this model
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: API key (sk-xxx)

````

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