调用SubmitAIAgentVideoAuditTask使用AI智能体异步审核视频-智能媒体服务-阿里云-智能媒体服务(IMS)-阿里云帮助中心

该接口是一个视频送审服务,通过AI智能体对视频内容进行审核,支持OSS输入,允许用户自定义视频截帧策略和审核规则,并通过异步回调的方式返回审核结果。

接口说明

通过 SubmitAIAgentVideoAuditTask 接口，用户可以提交包含视频地址、截帧策略、审核间隔等配置的审核任务，系统会返回一个唯一的 JobId 用于任务追踪,当任务完成后，系统会将审核结果（包括审核状态、AI 评估内容等）推送到用户配置的回调地址。仅支持 OSS 视频链接，mllm 只支持非流式 openai 协议，非流式 OpenAI 协议返回可以参考：自研模型标准 API 说明

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ice:SubmitAIAgentVideoAuditTask

none

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
AIAgentId	string	是	智能体 Id。	*****3b3d94abda22****
Input	object	是	输入文件。
Type	string	否	输入类型，取值： OSS：OSS 文件地址。	OSS
Media	string	否	输入文件信息，支持 OSS 地址。形如 http(s)://{BucketName}.{Endpoint}/{ObjectName} 当前只支持和服务同地域的 OSS，比如上海区域的接口服务只支持上海的 OSS。	http://my-bucket.oss-cn-shanghai.aliyuncs.com/object-id.mp4
UserData	string	否	用户自定义消息。	{"Custom":"hello"}
CallbackConfig	object	否	回调配置	{"Url":"https://yourcallback","Token":"yourtoken"}
Url	string	否	用户希望接收回调通知的 URL	https://yourcallback
Token	string	否	回调的鉴权 token，	Bearer Token
AuditInterval	integer	否	送审节奏（毫秒）：范围为 0-5000ms，默认值为 3000ms。当入参为 0 时，则将 CapturePolicies 中的所有截帧后的数据一次性请求对应 Agent 中的大模型。如果值为非 0，例如 3000ms，则代表着将所有截帧后的数据按 3000ms 为间隔有序请求大模型。	3000
CapturePolicies	array<object>	是	送审策略数组。每个策略会得到一个模型结果。
	object	否	单个策略。
FrameCount	integer	否	需要截取的帧数。	2
StartTime	integer	否	触发截帧的时刻（秒）	0
Duration	integer	否	单次截帧时长（秒）	10
Prompt	string	否	请求多模态大模型时的文本参数。	Please analyze the scene in the video

返回参数

名称	类型	描述	示例值
	object	Schema of Response
JobId	string	任务 Id	********fb04483915d4f2********
RequestId	string	请求 Id	********-586A-AC29-742247****

回调消息格式

参数说明

参数	类型	描述	示例值
JobId	String	任务 ID	bb940f584ccbef*
Status	String	任务状态	Success/Fail
Results	Array	处理结果数组	-
>	JSON Object	审核结果结构体	-
>> Content	String	MLLM 返回的结果	这几张图片审核通过！
UserData	String	用户自定义数据	{"businessId": "xxx"}
Message	String	消息	"Success"

响应示例

{
    "JobId": "*******bb940f584ccbef********",
    "Status": "Success",
    "Results": [
        {
            "Content": "这几张图片审核通过！"
        }
    ],
    "UserData": "{\"businessId\": \"xxx\"}",
    "Message": "Success"
}

示例

正常返回示例

JSON格式

{
  "JobId": "**********fb04483915d4f2**********",
  "RequestId": "**********-586A-AC29-742247******"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。