---
title: "视频任务状态"
method: GET
path: "/api/ai/video/generations/{taskId}"
tags: ["AI 服务/视频生成"]
---

# 视频任务状态

`GET /api/ai/video/generations/{taskId}`

接口说明：根据 taskId 查询视频生成任务的执行状态与结果。

## Path parameters

- `taskId` string, required

## Response `200`

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

- object
  - `data` VideoTaskStatusResponseVo
    - `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)