---
title: "视频任务列表"
method: GET
path: "/api/ai/video/generations"
tags: ["AI 服务/视频生成"]
---

# 视频任务列表

`GET /api/ai/video/generations`

接口说明：分页获取当前用户的视频生成任务列表。

## Query parameters

- `page` integer
- `pageSize` integer

## Response `200`

请求已被服务处理。业务是否成功以响应体 code === 0 为准。

- object
  - `data` ListVideoTasksResponseVo
    - `page` integer, required — 页码，从 1 开始
    - `pageSize` integer, required — 每页数量，建议结合接口限制设置合理大小
    - `totalPages` integer, required — 总页数
    - `total` integer, required — 总数量，用于分页场景中表示符合条件的数据总条数
    - `list` object[], required — 数据列表
      - `id` string, required — 任务 ID
      - `model` string, required — 模型名称
      - `status` string, required — 任务状态
      - `input` object, required — 输入参数
        - `prompt` string, required — 提示词
        - `groupId` string — 素材组 ID
        - `image` union — 图片 URL
          - string
          - string[]
        - `images` string[] — 参考图片 URL 列表
        - `audios` string[] — 参考音频 URL 列表
        - `duration` number — 时长（秒）
        - `aspectRatio` string — 宽高比
        - `resolution` string — 分辨率
        - `videoUrl` string — 首个参考视频 URL
        - `videos` string[] — 参考视频 URL 列表
      - `videoUrl` string — 生成的视频 URL
      - `coverUrl` string — 生成视频的封面 URL
      - `mediaId` string — 保存后的素材 ID
      - `groupId` string — 保存到的素材组 ID
      - `error` object — 错误信息
        - `message` string, required — 错误信息
      - `submittedAt` string, date-time, required — 提交时间
      - `startedAt` string, date-time, required — 开始时间
      - `finishedAt` string, date-time — 完成时间
  - `code` integer, required — 业务状态码。0 表示成功，非 0 表示业务错误。
  - `message` string, required — 响应消息。
  - `requestId` string — 请求 ID。
  - `timestamp` integer — 错误响应时间戳，Unix 毫秒。

---

[API](https://skmtc.net/aitoearn/apis/aitoearn-api.md) · [All operations](https://skmtc.net/aitoearn/apis/aitoearn-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aitoearn/aitoearn-api/versions/19d860d9260d/schema)