该接口是一个视频送审服务,通过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 |
| Media | string | 否 | 输入文件信息，支持 OSS 地址。 形如 http(s)://{BucketName}.{Endpoint}/{ObjectName} 当前只支持和服务同地域的 OSS，比如上海区域的接口服务只支持上海的 OSS。 | http://my-bucket.oss-cn-shanghai.aliyuncs.com/object-id.mp4 |
| UserData | string | 否 | 用户自定义消息。 | {"Custom":"你好"} |
| CallbackConfig | object | 否 | 回调配置 | |
| 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 | 否 | 请求多模态大模型时的文本参数。 | 请分析视频中的场景 |
返回参数
回调消息格式
参数说明
| 参数 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| 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******"
}错误码
访问错误中心查看更多错误码。