`GET https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/{id}` 查询视频生成任务的状态。

说明

仅支持查询最近 7 天的任务记录，时间区间为 [T\-7 天, T)，其中 T 为请求发起时刻的 UTC 时间戳（精确到秒）。

视频 URL 有效期为 24 小时，请及时下载或转存。

Seedance 2.5 模型生成的视频 URL 下载次数上限为 100 次。

## 鉴权本接口支持鉴权方式如下，详情请参见 [Base URL 及鉴权](https://ark.volcengine.com/region:cn-beijing/docs/ark/base-url-and-authentication)。 * API Key 鉴权，请在 [API Key 管理](https://ark.volcengine.com/region:cn-beijing/apiKey) 页面，获取长效 API Key。 --- ## 请求参数 ### Path 参数 **id** `string` `必选` | 任务 ID 您需要查询的视频生成任务的 ID ## 响应参数 **id** `string` | 任务 ID 视频生成任务 ID **model** `string` | 模型名称与版本任务使用的模型名称和版本，格式为 `模型名称-版本` **status** `string` | 任务状态任务状态，以及相关的信息： * `queued`：排队中。 * `running`：任务运行中。 * `cancelled`：取消任务，取消状态 24h 自动删除（只支持 `queued` 状态的任务被取消）。 * `succeeded`：任务成功。 * `failed`：任务失败。 **content** `object` | 输出内容视频生成任务的输出内容 **last_frame_url** `string` | 尾帧图像 URL `content.last_frame_url` 视频的尾帧图像 URL。有效期为 24 小时，请及时下载或转存。 Seedance 2.5 模型生成的视频 URL 下载次数上限为 100 次。说明：[创建视频生成任务](https://ark.volcengine.com/region:cn-beijing/docs/ark/create-video-generation-task-api) 时设置 `"return_last_frame": true` 时，会返回该参数。 **video_url** `string` | 视频 URL `content.video_url` 生成视频的 URL。有效期为 24 小时，请及时下载或转存。 Seedance 2.5 模型生成的视频 URL 下载次数上限为 100 次。推荐配置火山引擎 TOS 提供的数据订阅功能，将您的模型推理产物自动转存到自己的 TOS 桶中，便于长期备份或二次加工。详细介绍请参见 [TOS 数据订阅](https://docs.volcengine.com/docs/TorchObjectStorage/Datasubscription-5?lang=zh)。 **created_at** `integer` | 创建时间任务创建时间的 Unix 时间戳（秒） **duration** `integer` | 视频时长（秒）生成视频的时长，单位：秒。说明：**`duration`** ** 和 ** **`frames`** ** 参数只会返回一个**。创建视频生成任务时未指定 `frames`，会返回 `duration`。 **error** `object` | 错误信息错误提示信息。任务成功时返回 `null`，任务失败时返回错误数据，错误信息具体参见 [错误处理](https://ark.volcengine.com/region:cn-beijing/docs/ark/error-codes#common-error-codes-agent)。

注意

Seedance 2.5 模型在特定的任务类型中，需排队等待到任务被消费时，才会返回报错信息。详情参考报错机制。

**code** `string` | 错误码 `error.code` **message** `string` | 错误提示信息 `error.message` **execution_expires_after** `integer` | 任务超时阈值（秒）任务提交后的过期时间。任务超过该时间未完成会被自动终止，并标记为 `expired` 状态。 **frames** `integer` | 视频帧数生成视频的帧数。说明：**`duration`** ** 和 ** **`frames`** ** 参数只会返回一个**。创建视频生成任务时指定了 `frames`，会返回 `frames`。 **framespersecond** `integer` | 视频帧率生成视频的帧率 **generate_audio** `boolean` | 是否生成同步音频生成的视频是否包含与画面同步的声音。 * `true`：模型输出的视频包含同步音频。 * `false`：模型输出的视频为无声视频。 **模型支持**： * `Seedance 2.5` * `Seedance 2.0 系列` **output_format** `string` | 输出格式实际生成视频的格式（`mp4`或`mov`）。 **模型支持**： * `Seedance 2.5` **priority** `integer` | 执行优先级当前任务的执行优先级，与创建任务时设置的 `priority` 一致。取值范围为 0～9，数值越大，优先级越高。 **ratio** `string` | 宽高比生成视频的宽高比 **resolution** `string` | 分辨率生成视频的分辨率 **safety_identifier** `string` | 终端用户标识终端用户的唯一标识符。若创建任务时设置了该参数，接口会原样返回此信息 **seed** `integer` | 随机种子本次请求使用的种子整数值 **service_tier** `string` | 服务等级实际处理任务使用的服务等级 **tools** `object[]` | 实际使用的工具本次请求模型实际使用的工具。未使用工具时不返回 **模型支持**： * `Seedance 2.5` * `Seedance 2.0 系列` **type** `string` | 工具类型 `tools.type` 实际使用的工具类型。 * `web_search`：联网搜索工具 **updated_at** `integer` | 更新时间任务当前状态更新时间的 Unix 时间戳（秒） **usage** `object` | token 用量本次请求的 token 用量 **completion_tokens** `integer` | 生成视频消耗的 token 数 `usage.completion_tokens` 模型生成视频消耗的 token 数量，可作为计费对账依据。

注意

Seedance 2.0 系列模型存在最低 token 用量限制，如果实际 token 用量＜最低 token 用量，本字段会返回最低 token 用量，平台按最低 token 用量计费。

**total_tokens** `integer` | 总 token 数 `usage.total_tokens` 本次请求消耗的总 token 数量。视频生成模型不统计输入 token，输入 token 为 0，故 `total_tokens` = `completion_tokens` **tool_usage** `object` | 工具用量 `usage.tool_usage` 使用工具的用量信息 **web_search** `integer` | 联网搜索调用次数 `usage.tool_usage.web_search` 实际调用联网搜索工具的次数，仅开启联网搜索时返回