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

# 火山格式查询视频任务

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

## Request

- Base URL: `https://aitoearn.cn`
- URL: `https://aitoearn.cn/api/ai/v3/contents/generations/tasks/{taskId}`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/aitoearn/apis/aitoearn-api/docs/api/ai/v3/contents/generations/tasks/:taskId/get.ts> (a function with typed inputs; its response is checked against the schema)

接口说明：查询火山格式视频生成任务状态，返回结构保持火山任务查询格式。参考火山官方文档：[查询视频生成任务](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.dev/aitoearn/apis/aitoearn-api.md) - [All operations](https://skmtc.dev/aitoearn/apis/aitoearn-api/llms.txt) - [OpenAPI document](https://skmtc.dev/aitoearn/apis/aitoearn-api/revisions/7cc8f21c4c96?raw)