内容安全平台图文审核 Agent

1. 接口概述
请求域名：ims.tencentcloudapi.com
支持图片和文本作为输入：
图片要求：一次请求最多支持 5 张图片
文本要求：一次请求最多支持 5000 字
本接口为异步调用模式，单次审核耗时在分钟级：
默认并发：20，若需要增加并发路数，需要确保资源利用率，不支持脉冲式调用
队列处理机制：先进先出，即并发任务达到上限时，新任务进入队列等待处理
2. 接口参数
输入参数
参数名称
必选
类型
描述
Action
是
String
﻿公共参数，本接口取值：CreateImageModerationAsyncTask。
Version
是
String
﻿公共参数，本接口取值：2020-12-29。
Region
是
String
﻿公共参数，本接口取值：ap-guangzhou。
CallbackUrl
是
String
接收审核信息回调地址，审核结果将发送至此地址。
示例值：https://examplexxxxxxxx.com
BizType
是
String
该字段唯一标识审核策略，获取方式请联系商务或架构师。
示例值：tianyu_ad_quality_audit_xxxx
FileUrlList
否
Array of String
待审核图片的 URL ，一次请求最多支持传入5张图片。该字段与 TextContent 至少填一个。
示例值：['https://xxxxxxxxx1.jpg', 'https://xxxxxxxxx2.jpg']
TextContent
否
String
待审的文本内容，需为 UTF-8编码并以 Base64 格式传入，字数限制 5000 字内。
示例值：5L2g55qE5Lil6LCo6K6p5L2g5Y+R546w77yM5Lqn5ZOB57uP5
Type
是
String
固定取值：IMAGE_LLM
图片要求：
支持格式：BMP、JPEG、PNG、PNG、RAW、SVG、WEBP
文件大小：单图大小不超过 30 MB，分辨率不低于 256 × 256
链接与下载：
链接要求：仅支持 HTTP 和 HTTPS 协议，且必须为直接指向图片资源的链接
下载超时：下载超时时间为 15 秒，失败后重试 1 次为 3 秒，共18 秒下载时间
存储建议：推荐使用腾讯云 COS 或 CDN 缓存服务存放图片，保障访问的稳定性和可靠性
输出参数
参数名称
类型
描述
RequestId
String
唯一请求 ID，由服务端生成，每次请求都会返回，定位问题时需要使用该字段的值。
说明：若请求因其它原因未能抵达腾讯云天御的服务端，则该次请求不会获得 RequestId。
DataId
String
兼容字段，在审核 Agent 服务下该字段无实际含义，返回为空。
回调参数
参数名称
类型
描述
RequestId
String
对应输出参数中的 RequestId
BizType
String
对应输入参数中的 BizType
Label
String
命中的模型标签（标签来自下方的 LabelName 透传，当命中多个标签时，用逗号分隔）
示例：LianXiFangShi,YouDaoDianJi,BiaoTiDang
Suggestion
String
服务处置建议，枚举取值：Block、Review、Pass。判定规则如下：
Block（建议按违规处置）：原子能力中有一个返回 Block，则该字段为 Block。
Review（建议人工复审）：原子能力中无 Block 返回、但有 Review，则该字段为 Review。
Pass（未识别到违规项）：所有原子能力返回 Pass。（注意：若出现全部原子能力审核失败也会返回 Pass，因此需要搭配 Status 字段来使用）
Status
String
success：所有原子能力审核成功，则返回 success
fail：只要有一个原子能力审核失败，则返回 fail
Detail
ObjectArray
本次任务执行的所有审核原子能力的结果，以数组的形式输出。单个原子能力的结构如下：
参数
类型
必有
参数描述
LabelName
String
是
审核原子能力名称
Reason
String
否
模型的判断原因，无则可不输出
TargetText
StringArray
否
命中的文本片段列表，无则可不输出
Suggestion
String
否
处置建议，枚举取值：Block、Review、Pass
Extra
Object
否
扩展业务字段，基于客户要求配置。例如：
{
  "ClusterID":"IT1",
  "Dimension":"ZT-5",
  "SubSignalID":"IT1.2",
  "Level":"L5"
}
Suggestion 和 Status 字段使用说明：
Status 返回 success，则所有原子能力审核成功，Suggestion 是所有原子能力审核结果的聚合判断
Status 返回 fail，则存在原子能力审核失败，如果：
全部审核失败：Suggestion 返回 Pass
部分审核失败：Suggestion 是剩下的原子能力审核结果的聚合判断
CallbackUrl 参数说明：
CallbackUrl 为客户侧的公网可访问的回调服务地址，接口采用 POST 请求方式推送回调通知
回调报文外层统一封装固定的 Response 结构，客户解析数据时，请读取 Response 节点下的内容进行后续业务处理
若回调发生异常，错误信息将在 Response 内的 Error 字段中返回
3. 调用示例
输入示例
POST / HTTP/1.1
Host: ims.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateImageModerationAsyncTask
<公共请求参数>
{
    "CallbackUrl": "https://examplexxxxxxx.com",
    "BizType": "tianyu_ad_quality_audit_xxxx",
    "FileUrlList": ["https://test1.jpg", "https://test2.jpg"],
    "TextContent": "5L2g55qE5Lil6LCo6K6p5L2g5Y+R546w77yM5Lqn5ZOB57uP55CG5Y+r5YmR6Z2S",
    "Type": "IMAGE_LLM"
}
输出示例
{
    "Response": {
        "RequestId": "193101e1-e9b6-4a9b-b29e-6e37db58beef",
        "DataId": ""
    }
}
回调示例
{
    "Response": {
        "RequestId": "5a13f336-d09b-4dfa-aa0b-e473686cea65",
        "DataId": "",
        "BizType": "tianyu_ad_quality_audit_xxxx",
        "Suggestion": "Block",
        "Label": "LianXiFangShi,YouDaoDianJi,BiaoTiDang",
        "Status": "success",
        "Detail": [
            {
                "LabelName": "LianXiFangShi",
                "Reason": "IT1.2 hit. Evidence: 出现线下手机号码的联系方式",
                "TargetText": [],
                "Suggestion": "Block",
                "Extra": {}
            },
            {
                "LabelName": "YouDaoDianJi",
                "Reason": "IT1.2 hit. Evidence: 虚假关闭按钮，诱导用户点击产生二跳",
                "TargetText": [],
                "Suggestion": "Block",
                "Extra": {}
            },
            {
                "LabelName": "KuaZhangYinXiao",
                "Reason": "文本内容xxxxxxxxxxx属于正常的营销说法，也未包含xxx、xxx等违规词汇。",
                "TargetText": [],
                "Suggestion": "Pass",
                "Extra": {}
            },
            {
                "LabelName": "BiaoTiDang",
                "Reason": "I3.3 hit. Evidence: xxxxxxx采用震惊体的说法",
                "TargetText": [],
                "Suggestion": "Block",
                "Extra": {}
            }
        ]
    }
}
﻿

参数名称	必选	类型	描述
Action	是	String	公共参数，本接口取值：CreateImageModerationAsyncTask。
Version	是	String	公共参数，本接口取值：2020-12-29。
Region	是	String	公共参数，本接口取值：ap-guangzhou。
CallbackUrl	是	String	接收审核信息回调地址，审核结果将发送至此地址。示例值：https://examplexxxxxxxx.com
BizType	是	String	该字段唯一标识审核策略，获取方式请联系商务或架构师。示例值：tianyu_ad_quality_audit_xxxx
FileUrlList	否	Array of String	待审核图片的 URL ，一次请求最多支持传入5张图片。该字段与 TextContent 至少填一个。示例值：['https://xxxxxxxxx1.jpg', 'https://xxxxxxxxx2.jpg']
TextContent	否	String	待审的文本内容，需为 UTF-8编码并以 Base64 格式传入，字数限制 5000 字内。示例值：5L2g55qE5Lil6LCo6K6p5L2g5Y+R546w77yM5Lqn5ZOB57uP5
Type	是	String	固定取值：IMAGE_LLM

图文审核 Agent

本页目录：

1. 接口概述

2. 接口参数

输入参数

输出参数

回调参数

3. 调用示例

输入示例

输出示例

回调示例