图像识别

    快速入门

    安装ImageClassify Java SDK

    ImageClassify Java SDK目录结构

    com.baidu.aip
           ├── auth                                //签名相关类
           ├── http                                //Http通信相关类
           ├── client                              //公用类
           ├── exception                           //exception类
           ├── imageclassify
           │       └── AipImageClassify           //AipImageClassify类
           └── util                                //工具类

    支持 JAVA版本:1.7+

    查看源码

    Java SDK代码现已公开,您可以查看代码、或者在License范围内修改和编译SDK以适配您的环境。 github链接:https://github.com/Baidu-AIP/java-sdk

    使用maven依赖

    添加以下依赖即可。其中版本号可在maven官网查询

    <dependency>
        <groupId>com.baidu.aip</groupId>
        <artifactId>java-sdk</artifactId>
        <version>${version}</version>
    </dependency>

    直接使用JAR包步骤如下

    1.在官方网站下载Java SDK压缩工具包。

    2.将下载的aip-java-sdk-version.zip解压后,复制到工程文件夹中。

    3.在Eclipse右键“工程 -> Properties -> Java Build Path -> Add JARs”。

    4.添加SDK工具包aip-java-sdk-version.jar和第三方依赖工具包json-20160810.jar slf4j-api-1.7.25.jar slf4j-simple-1.7.25.jar(可选)

    其中,version为版本号,添加完成后,用户就可以在工程中使用ImageClassify Java SDK。

    新建AipImageClassify

    AipImageClassify是图像识别的Java客户端,为使用图像识别的开发人员提供了一系列的交互方法。

    用户可以参考如下代码新建一个AipImageClassify,初始化完成后建议单例使用,避免重复获取access_token:

    public class Sample {
        //设置APPID/AK/SK
        public static final String APP_ID = "你的 App ID";
        public static final String API_KEY = "你的 Api Key";
        public static final String SECRET_KEY = "你的 Secret Key";
    
        public static void main(String[] args) {
            // 初始化一个AipImageClassify
            AipImageClassify client = new AipImageClassify(APP_ID, API_KEY, SECRET_KEY);
    
            // 可选:设置网络连接参数
            client.setConnectionTimeoutInMillis(2000);
            client.setSocketTimeoutInMillis(60000);
    
            // 可选:设置代理服务器地址, http和socket二选一,或者均不设置
            client.setHttpProxy("proxy_host", proxy_port);  // 设置http代理
            client.setSocketProxy("proxy_host", proxy_port);  // 设置socket代理
    
            // 调用接口
            String path = "test.jpg";
            JSONObject res = client.objectDetect(path, new HashMap<String, String>());
            System.out.println(res.toString(2));
            
        }
    }

    在上面代码中,常量APP_ID在百度云控制台中创建,常量API_KEYSECRET_KEY是在创建完毕应用后,系统分配给用户的,均为字符串,用于标识用户,为访问做签名验证,可在AI服务控制台中的应用列表中查看。

    注意:如您以前是百度云的老用户,其中API_KEY对应百度云的“Access Key ID”,SECRET_KEY对应百度云的“Access Key Secret”。

    配置AipImageClassify

    如果用户需要配置AipImageClassify的一些细节参数,可以在构造AipImageClassify之后调用接口设置参数,目前只支持以下参数:

    接口 说明
    setConnectionTimeoutInMillis 建立连接的超时时间(单位:毫秒)
    setSocketTimeoutInMillis 通过打开的连接传输数据的超时时间(单位:毫秒)
    setHttpProxy 设置http代理服务器
    setSocketProxy 设置socket代理服务器 (http和socket类型代理服务器只能二选一)

    SDK默认使用slf4j-simple包进行日志输出,若用户需要使用自定义日志实现,可去除slf4j-simple依赖包,再额外添加相应的日志实现包即可。 maven去除slf4j-simple依赖包示例:

    <dependency>
        <groupId>com.baidu.aip</groupId>
        <artifactId>java-sdk</artifactId>
        <version>${version}</version>
        <exclusions>
            <exclusion>
                <groupId>org.slf4j</groupId>
                <artifactId>slf4j-simple</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
    上一篇
    简介
    下一篇
    接口说明