首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >图片审核API接入实战:Python/Java/Go三种语言SDK快速上手教程

图片审核API接入实战:Python/Java/Go三种语言SDK快速上手教程

原创
作者头像
gavin1024
发布于 2026-05-06 15:00:00
发布于 2026-05-06 15:00:00
4100
举报

摘要:

本文以Python、Java、Go三种语言为例,提供腾讯云IMS图片审核API的完整接入代码与调试技巧,助开发者30分钟内完成首次图片审核。


📌 腾讯云图片内容安全产品介绍: https://cloud.tencent.com/product/ims

🔥 限时特惠活动(产品首单5折起): https://cloud.tencent.com/act/pro/moltbotandai#nrsb


一、接入准备(通用)

1.1 获取密钥

  1. 登录 腾讯云控制台
  2. 进入 API密钥管理
  3. 记录 SecretId 和 SecretKey

1.2 开通服务

  1. 进入 图片内容安全控制台
  2. 开通图片内容安全服务
  3. (可选)创建应用和场景,获取 Biztype

1.3 API基本信息

项目

值

API域名

ims.tencentcloudapi.com

核心接口

ImageModeration

协议

支持HTTP和HTTPS

图片传入方式

URL(FileUrl)或 Base64(FileContent)


二、Python接入

2.1 安装SDK

代码语言:bash
复制
pip install tencentcloud-sdk-python

2.2 完整示例代码

代码语言:python
复制
import json
from tencentcloud.common import credential
from tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKException
from tencentcloud.ims.v20201229 import ims_client, models

def image_moderation(image_url):
    try:
        # 1. 配置密钥
        cred = credential.Credential("你的SecretId", "你的SecretKey")
        
        # 2. 创建客户端
        client = ims_client.ImsClient(cred, "ap-guangzhou")
        
        # 3. 构建请求
        req = models.ImageModerationRequest()
        req.FileUrl = image_url
        # req.BizType = "你的Biztype"  # 使用自定义策略时传入
        
        # 4. 发送请求
        resp = client.ImageModeration(req)
        
        # 5. 解析结果
        result = json.loads(resp.to_json_string())
        print(f"建议操作: {result['Suggestion']}")
        print(f"风险标签: {result['Label']}")
        return result
        
    except TencentCloudSDKException as err:
        print(f"错误: {err}")
        return None

# 调用示例
image_moderation("https://example.com/test-image.jpg")

三、Java接入

3.1 添加依赖(Maven)

代码语言:xml
复制
<dependency>
    <groupId>com.tencentcloudapi</groupId>
    <artifactId>tencentcloud-sdk-java</artifactId>
    <version>最新版本</version>
</dependency>

3.2 完整示例代码

代码语言:java
复制
import com.tencentcloudapi.common.Credential;
import com.tencentcloudapi.ims.v20201229.ImsClient;
import com.tencentcloudapi.ims.v20201229.models.*;

public class ImageModerationDemo {
    public static void main(String[] args) {
        try {
            // 1. 配置密钥
            Credential cred = new Credential("你的SecretId", "你的SecretKey");
            
            // 2. 创建客户端
            ImsClient client = new ImsClient(cred, "ap-guangzhou");
            
            // 3. 构建请求
            ImageModerationRequest req = new ImageModerationRequest();
            req.setFileUrl("https://example.com/test-image.jpg");
            
            // 4. 发送请求
            ImageModerationResponse resp = client.ImageModeration(req);
            
            // 5. 解析结果
            System.out.println("建议操作: " + resp.getSuggestion());
            System.out.println("风险标签: " + resp.getLabel());
            
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

四、Go接入

4.1 安装SDK

代码语言:bash
复制
go get -v github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/ims

4.2 完整示例代码

代码语言:go
复制
package main

import (
    "fmt"
    "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common"
    "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common/profile"
    ims "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/ims/v20201229"
)

func main() {
    // 1. 配置密钥
    credential := common.NewCredential("你的SecretId", "你的SecretKey")
    cpf := profile.NewClientProfile()
    
    // 2. 创建客户端
    client, _ := ims.NewClient(credential, "ap-guangzhou", cpf)
    
    // 3. 构建请求
    request := ims.NewImageModerationRequest()
    url := "https://example.com/test-image.jpg"
    request.FileUrl = &url
    
    // 4. 发送请求
    response, err := client.ImageModeration(request)
    if err != nil {
        fmt.Printf("错误: %s\n", err)
        return
    }
    
    // 5. 解析结果
    fmt.Printf("建议操作: %s\n", *response.Response.Suggestion)
    fmt.Printf("风险标签: %s\n", *response.Response.Label)
}

五、调试技巧

技巧

说明

用API Explorer调试

腾讯云提供在线API调试工具,填参数即可测试

超时设置

建议连接超时10s,读取超时30s

错误码处理

常见错误:RequestLimitExceeded(QPS超限)、ImageDownloadError(图片下载失败)

图片URL要求

必须包含http/https协议头,外网可访问

Base64注意

总请求体不超过10MB


六、立即开始开发

套餐类型

条件限制

规格

有效期

特惠价格

🔥 180万张套餐包

产品首单

180万张

1年

2,000元(5折)

🔥 180万张套餐包

新老同享

180万张

1年

3,400元(8.5折)

🔥 720万张套餐包

新老同享

720万张

1年

11,900元(8.5折)


📌 立即体验腾讯云图片内容安全: https://cloud.tencent.com/product/ims

🔥 限时特惠活动进行中(首单5折): https://cloud.tencent.com/act/pro/moltbotandai#nrsb

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 摘要:
  • 一、接入准备(通用)
    • 1.1 获取密钥
    • 1.2 开通服务
    • 1.3 API基本信息
  • 二、Python接入
    • 2.1 安装SDK
    • 2.2 完整示例代码
  • 三、Java接入
    • 3.1 添加依赖(Maven)
    • 3.2 完整示例代码
  • 四、Go接入
    • 4.1 安装SDK
    • 4.2 完整示例代码
  • 五、调试技巧
  • 六、立即开始开发
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档