---
title: "火山格式查询视频任务"
method: GET
path: "/api/ai/v3/contents/generations/tasks/{taskId}"
tags: ["AI 服务/视频生成"]
---

# 火山格式查询视频任务

`GET /api/ai/v3/contents/generations/tasks/{taskId}`

接口说明：查询火山格式视频生成任务状态，返回结构保持火山任务查询格式。参考火山官方文档：[查询视频生成任务](https://www.volcengine.com/docs/82379/1521309?lang=zh)。

## Path parameters

- `taskId` string, required

## Response `200`

火山格式原生响应，不使用 AiToEarn 通用响应包裹。

- VolcengineTaskStatusResponseVo
  - `id` string, required — 任务ID
  - `model` string, required — 模型名称
  - `status` string, required — 任务状态
  - `error` object, nullable — 错误信息
    - `message` string, required
    - `code` string, required
  - `created_at` number, required — 创建时间
  - `updated_at` number, required — 更新时间
  - `content` object — 视频内容
    - `video_url` string
    - `last_frame_url` string
  - `seed` number — 种子值
  - `resolution` string — 分辨率
  - `ratio` string — 宽高比
  - `duration` number — 时长
  - `framespersecond` number — 帧率
  - `usage` object — 使用量统计
    - `completion_tokens` number
    - `total_tokens` number
    - `tool_usage` object
      - `web_search` number
  - `generate_audio` boolean — 是否包含同步音频
  - `tools` object[] — 本次请求模型实际使用的工具
    - `type` string, required — 实际使用的工具类型
  - `safety_identifier` string — 终端用户标识（原样回显）
  - `priority` number — 任务执行优先级
  - `execution_expires_after` number — 任务超时阈值（秒）

---

[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)