文档中心

AI MediaKit

其他

查询任务信息 API

GET https://mediakit.cn-beijing.volces.com/api/v1/tasks/{task_id}

本接口用于查询指定 task_id 的异步任务状态和最终结果。在提交异步任务后，您可以间隔一定时间轮询此接口来获取任务的最新动态。

注意

查询时效性调整：自 2026 年 8 月 20 日起，本 API 仅支持查询 30 天内创建的任务。查询超过 30 天的任务将失败。详情请参见 AI MediaKit 查询任务信息 API 查询范围调整公告。

产物存储策略变更：自 2026 年 9 月 23 日起，AI MediaKit 调整输出产物的存储策略。通过本 API 查询任务所获取的默认产物下载链接，从生成时刻起固定 24 小时有效，不再支持自动续期。请您务必确保在产物生成后 24 小时内完成下载或转存。详情请参见 AI MediaKit 输入文件及输出产物存储策略调整公告。

说明

在生产环境中，您也可配置事件回调。配置后，AI MediaKit 会在任务完成时主动将结果推送到您的服务器，从而避免不必要的轮询。

接口特性

结果时效：任务成功后的结果数据（如默认产物下载链接）将严格遵守 24 小时有效期（从生成时刻起计算），不支持续期；请及时下载或在提交任务时将产物转存至 VOD/TOS。

请求参数

Path 参数

参数	类型	是否必选	示例值	描述
task_id	String	是	amk-tool-mux-audio-video-14***24	任务的唯一标识。在提交异步任务时，从响应体中获取。

Header 参数

参数	类型	是否必选	示例值	描述
Authorization	String	是	Bearer {Your_API_Key}	格式为 Bearer {Your_API_Key}。请参考基础概念及准备工作获取 API Key。

请求示例

响应参数

接口的响应体为一个 JSON 对象，包含了任务的详细信息。

参数	类型	描述
success	Boolean	标识本次 API 请求是否被成功处理。 true：服务端成功处理了查询请求。 false：请求失败，具体原因请查看 error 字段。说明此字段仅代表查询操作本身是否成功，不代表任务的执行状态。
task_id	String	所查询任务的唯一标识。
task_type	String	任务类型。例如 mux-audio-video（视频加音频）、enhance-video（画质增强）等。
status	String	任务当前的状态。枚举值： running：任务正在处理中。 completed：任务已成功完成。 failed：任务处理失败。
result	Object	任务成功时返回的结果对象。仅当 status 为 completed 时返回。其具体结构因 task_type 而异。您可参考提交具体任务的 API 文档来获取 result 的详细结构。
error	Object	任务失败时返回的错误详情对象。仅当 status 为 failed 时返回。其内容结构请参见下文 Error 对象。
expires_at	Integer	任务结果的过期时间戳（Unix Time，单位：秒）。仅当任务成功且有结果时返回。
created_at	Integer	任务创建时间戳（Unix Time，单位：秒）。
finished_at	Integer	任务完成（成功或失败）的时间戳（Unix Time，单位：秒）。仅当 status 为 completed 或 failed 时出现。
request_id	String	本次 API 请求的唯一标识符，可用于问题排查。
queue_id	String	任务所属的队列 ID。

Error 对象

当 success 为 false 或 status 为 failed 时，会返回 error 对象，包含错误详情。

参数	类型	描述
code	String	错误码。详见错误码。
message	String	错误描述信息，用于展示或记录日志。
param	String	(可选) 指示导致错误的具体参数名。
type	String	错误类型，如 TaskError 表示任务执行出错，ApiError 表示 API 调用出错。

响应示例

示例 1：任务正在运行

示例 2：任务成功完成（以音视频叠加为例）

示例 3：任务执行失败

最近更新时间：2026.10.10 16:31:01

这个页面对您有帮助吗？

有用

无用