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

# List video tasks · Ark

> List tasks from the last 7 days with pagination and status filters.

`GET /v1/contents/generations/tasks?page_num=1&page_size=20` lists tasks from the last 7 days and accepts `filter.status`, `filter.model` and `filter.task_ids`.

List items have the same structure as a [single task](/en/api/video-ark-get).


## OpenAPI

````yaml openapi/relay.en.json GET /v1/contents/generations/tasks
openapi: 3.0.1
info:
  title: AIOHub API
  description: AIOHub public API
  version: 1.0.0
servers:
  - url: https://api.aiohub.org
security:
  - BearerAuth: []
tags:
  - name: List models
  - name: OpenAI Chat
  - name: OpenAI Responses
  - name: Image generation
  - name: OpenAI Images
  - name: Video generation
  - name: Claude Messages
  - name: Gemini API
  - name: OpenAI Embeddings
  - name: Text completions
  - name: OpenAI Audio
  - name: Realtime API
paths:
  /v1/contents/generations/tasks:
    get:
      tags:
        - Video generation
      summary: List video tasks
      description: >
        Returns the caller's video tasks from the last 7 days, newest first.
        Items have the same shape as a single task read.
      operationId: listSeedanceVideoTasks
      parameters:
        - name: page_num
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 500
            default: 1
          description: Page number
        - name: page_size
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 500
            default: 20
          description: Items per page
        - name: filter.status
          in: query
          required: false
          schema:
            type: string
            enum:
              - queued
              - running
              - succeeded
              - failed
              - cancelled
              - expired
          description: Filter by status
        - name: filter.model
          in: query
          required: false
          schema:
            type: string
          example: doubao-seedance-2-5-260628
          description: Filter by model
        - name: filter.task_ids
          in: query
          required: false
          schema:
            type: array
            items:
              type: string
          style: form
          explode: true
          description: Filter by task ID, repeatable
      responses:
        '200':
          description: Task list
          headers: {}
          content:
            application/json:
              schema:
                type: object
                properties:
                  total:
                    type: integer
                    description: Total matching tasks
                  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: Missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          headers: {}
      deprecated: false
      security:
        - BearerAuth: []
components:
  schemas:
    SeedanceTask:
      type: object
      description: Video task object.
      properties:
        id:
          type: string
          description: Task ID
          example: task_ADQ5XK6AKWg36WePoJ3sZRyDvWl1ogGZ
        model:
          type: string
          example: doubao-seedance-2-5-260628
        status:
          type: string
          enum:
            - queued
            - running
            - succeeded
            - failed
            - cancelled
            - expired
          description: Task status
        error:
          nullable: true
          allOf:
            - $ref: '#/components/schemas/SeedanceTaskError'
          description: Error when the task did not succeed, otherwise `null`.
        content:
          type: object
          nullable: true
          description: >-
            Artifact URLs when `status` is `succeeded`. Download with the same
            API key.
          properties:
            video_url:
              type: string
              example: >-
                https://api.aiohub.org/v1/videos/task_ADQ5XK6AKWg36WePoJ3sZRyDvWl1ogGZ/content
            last_frame_url:
              type: string
              description: >-
                Present only when the task was created with `return_last_frame:
                true`.
        usage:
          type: object
          properties:
            completion_tokens:
              type: integer
              description: >-
                Billed video tokens of the delivered video. See [Video
                generation](/en/api/video#pricing).
            total_tokens:
              type: integer
        output_format:
          type: string
          example: mp4
        framespersecond:
          type: integer
          example: 24
        resolution:
          type: string
          description: >-
            The requested value while running; the delivered value after
            success.
        ratio:
          type: string
          description: >-
            The requested value while running; the delivered value after
            success.
        duration:
          type: integer
          description: >-
            The requested value while running; the delivered value after
            success.
        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: Creation time, Unix seconds
        updated_at:
          type: integer
          description: Last update time, Unix seconds
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
              description: Error message
            type:
              type: string
              description: Error type
            param:
              type: string
              description: Related parameters
              nullable: true
            code:
              type: string
              description: Error code
              nullable: true
    SeedanceTaskError:
      type: object
      description: Error response of the video task endpoints.
      properties:
        code:
          type: string
          description: Error code
          example: invalid_duration
        message:
          type: string
          description: Error message
          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.