图片异步检测

1. 接口描述

接口请求域名： ims.tencentcloudapi.com 。

接口使用说明

本接口适用于"标准内容安全"、"AI 生成识别"、"图文审核 Agent"服务，对接前请先参考快速入门，配置好业务基础信息。

• 标准内容安全-快速入门：https://cloud.tencent.com/document/product/1124/135196
• AI 生成识别-快速入门：https://cloud.tencent.com/document/product/1124/135204
• 图文审核 Agent：接口兼容，具体调用方式请联系商务获取

接口功能说明

• 标准内容安全：对图片内容进行检测，识别其中不安全、不适宜的信息
• AI 生成识别：识别图像中使用大模型工具的生成痕迹，判断图片是否存在 AI 生成风险
• 图文审核 Agent：基于大模型能力，按客户自定义的业务规则审核图片及文本内容

接口调用说明

• 支持格式

  • 静态图：BMP、ICO、JPEG、JNG、PNG、TIFF、RAW、SVG、GIF、WEBP、HEIC、HEIF、AVIF
  • 动态图：GIF、WEBP、HEIC（每 5 帧均匀采样 1 次，默认最多抽取 5 帧）

• 文件大小

  • 尺寸：图片宽高需大于 20 px 且小于 10000 px，宽高比小于 90:1
  • 分辨率：建议大于 256×256，以保证识别效果
  • 大小：文件最小 16 字节；通过 Base64 编码输入需小于 10 MB；通过 FileURL 访问的源图需小于 30 MB

• 链接与下载

  • 并发限制：每次仅能传输一条 URL，支持多并发请求，默认并发 20 QPS，超出返回 RequestLimitExceeded
  • 链接要求：仅支持 HTTP 和 HTTPS 协议，且必须为直接指向图片资源的链接，不支持异步回源；受网络安全策略影响，带 HTTP 302 重定向的链接可能下载失败，因重定向或其他原因导致的下载失败，返回 ResourceUnavailable.ImageDownloadError
  • 下载超时：下载超时时间为 15 秒，失败后重试 1 次（间隔 3 秒），共 18 秒下载时间；重试仍失败则返回 ImageDownloadError
  • 存储建议：为保障被检测图片的访问稳定性和可靠性，建议使用腾讯云 COS 存储或 CDN 缓存

接口回调格式

图片异步检测接口的回调格式与图片同步检测接口输出参数一致，详见 图片同步检测接口输出参数。

默认接口请求频率限制：20次/秒。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。

3. 输出参数

4. 示例

示例1 创建异步审核任务示例

创建异步审核任务示例

输入示例

POST / HTTP/1.1
Host: ims.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateImageModerationAsyncTask
<公共请求参数>

{
    "BizType": "TencentCloudDefault",
    "FileUrl": "https://test.jpg",
    "DataId": "a61237dd-c2a0-43e7-a3da-d27022d39ba7",
    "CallbackUrl": "https://callback.example.com/tencnet/callback",
    "Type": "IMAGE"
}

输出示例

{
    "Response": {
        "RequestId": "193101e1-e9b6-4a9b-b29e-6e37db58beef",
        "DataId": "a61237dd-c2a0-43e7-a3da-d27022d39ba7"
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

• Tencent Cloud SDK 3.0 for Python: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for Java: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for PHP: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for Go: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for Node.js: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for .NET: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for C++: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for Ruby: CNB, GitHub, Gitee

命令行工具

• Tencent Cloud CLI 3.0

6. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。