对于 AI MediaKit 的异步媒体处理任务（如音视频拼接、画质增强等），为了及时获取任务结果，建议您配置事件回调。当任务执行完成时，AI MediaKit 会主动向您指定的服务器地址发送 POST 请求，推送任务状态及结果数据。

回调机制

您需要部署一个 HTTP/HTTPS 服务来接收回调消息，并在 AI MediaKit 控制台中配置回调地址。AI MediaKit 的回调机制具体如下：

重试机制：若回调失败（响应非 200 或连接超时），AI MediaKit 会发起最多 3 次重试，重试间隔依次为 5 秒、10 秒和 30 秒。若 3 次重试均失败，该通知将被丢弃。

配置回调订阅

步骤 1：勾选事件

步骤 2：配置接收地址

在回调订阅区域，创建新的回调订阅，用于指定接收回调通知的地址和方式。具体步骤如下：

请求 Content-Type：选择回调请求的 Content-Type。这将影响 AI MediaKit 服务向回调地址发送请求时请求体的数据格式。支持以下两种类型：

步骤 3：进行连通性测试

单任务执行完成事件

当您提交的异步任务（如视频拼接、画质增强等）执行完成（无论成功或失败）时，AI MediaKit 会向您配置的回调地址推送此事件。

参数说明

字段	类型	是否必填	示例	描述
RequestId	String	是	2026032520...	本次回调请求的唯一 ID。
Version	String	是	1.0	事件版本号，例如 "1.0"。
EventType	String	是	AIMediaKitTaskComplete	事件类型，固定为 AIMediaKitTaskComplete。
EventTime	String	是	2026-03-25T12:44:34Z	事件发生的 UTC 时间，格式为 YYYY-MM-DDTHH:mm:ssZ。
Data	Object	是	{...}	包含任务处理结果的核心数据对象。详见 Data 对象。
TaskId	String	是	amk_tool_...	任务的唯一标识，与 Data.TaskId 的值相同。

Data 对象

Data 对象包含了任务的最终状态和结果。

字段	类型	是否必填	示例	描述
Code	String	是	Success	任务执行结果的状态码。 Success 表示成功。 Failed 表示失败。
Message	String	是	AIMediaKit Task Success	任务执行结果的描述信息。
TaskId	String	是	amk_tool_...	任务的唯一标识。
Result	Object	是	{...} 或 null	任务成功时返回的结果数据对象，失败时为 null。具体结构因任务类型而异。您可参考提交具体任务的 API 文档。
CallbackArgs	String	否	{"user_id":"abc"}	自定义回调参数。如果您在提交任务时设置了 callback_args 参数，其内容将在此字段中原样返回。如果提交时未设置，则回调中不包含此字段。
QueueId	String	是	q00a9731598092652e4a95292434198	任务所属的队列 ID。

回调示例

以音视频合成任务为例：