SDK参考

Similar documents
API参考

SDK参考

SDK参考

获取 Access Token access_token 是接口的全局唯一票据, 接入方调用各接口时都需使用 access_token 开发者需要进行妥善保存 access_token 的存储至少要保留 512 个字符空间 access_token 的有效期目前为 2 个小时, 需定时刷新, 重复

SDK 概要 使用 Maven 的用户可以从 Maven 库中搜索 "odps-sdk" 获取不同版本的 Java SDK: 包名 odps-sdk-core odps-sdk-commons odps-sdk-udf odps-sdk-mapred odps-sdk-graph 描述 ODPS 基

常见问题

云数据库 RDS SDK

SDK参考

SDK参考

SDK参考

停止混流接口 请注意 : 该功能需要联系 ZEGO 技术支持开通 1 接口调用说明 http 请求方式 : POST/FORM, 需使用 https 正式环境地址 access_token=access_token (http

SDK参考

最佳实践

SDK参考

用户指南

untitled

中華民國九十三年 月 日

}; "P2VTKNvTAnYNwBrqXbgxRSFQs6FTEhNJ", " " string imagedata; if(0!= read_image("a.jpg",imagedata)) { return -1; } string rsp; ytopen_sdk m_sd

Microsoft Word - 在VMWare-5.5+RedHat-9下建立本机QTopia-2.1.1虚拟平台a.doc

Kubenetes 系列列公开课 2 每周四晚 8 点档 1. Kubernetes 初探 2. 上 手 Kubernetes 3. Kubernetes 的资源调度 4. Kubernetes 的运 行行时 5. Kubernetes 的 网络管理理 6. Kubernetes 的存储管理理 7.

内部明电

Partition Key: 字 符 串 类 型, 表 示 当 前 Entity 的 分 区 信 息 这 个 Property 对 于 Table Service 自 动 纵 向 和 横 向 扩 展 至 关 重 要 Row Key: 字 符 串 类 型, 在 给 定 Partition Key 的

快速入门

1.JasperReport ireport JasperReport ireport JDK JDK JDK JDK ant ant...6

電機工程系認可證照清單 /7/1

國立嘉義高中 103 學年度第 1 學期第 6 次行政會議紀錄 日期時間 103 年 12 月 15 日(星期一) 時間 08:30~ 地點 旭陵樓 3 樓第 1 會議室 主席 黃校長義春 紀錄彙整 葉國宗 參加人員 如簽到表 壹 主席報告 1.今天上午 11:30 要出發至溪湖高中進行 104 學

条款

紅 獅 傳 說 的 漫 畫 封 面 遊 戲 的 世 界 觀 是 發 生 在 黑 魔 法 與 白 魔 法 盛 行 的 時 代, 這 是 個 充 滿 龍 與 騎 士 魔 法 師 與 精 靈 的 神 話 世 界, 有 著 無 數 的 王 公 貴 族, 存 在 著 正 義 與 邪 惡, 以 及 從 歷 史

業 用 地 出 讓 最 低 價 標 準 不 得 低 於 土 地 取 得 成 本 土 地 前 期 開 發 成 本 和 按 規 定 收 取 的 相 關 費 用 之 和 工 業 用 地 必 須 採 用 招 標 拍 賣 掛 牌 方 式 出 讓 其 出 讓 價 格 不 得 低 於 公 佈 的 最 低 價 標

新美大酒店开放平台SDK(.NET版)使用说明.pages

<4D F736F F D20BBF9D3DA416E64726F6964C6BDCCA8B5C4B5E7D7D3C5C4C2F4CFB5CDB32E646F63>

目 錄 版 次 變 更 記 錄... 2 原 始 程 式 碼 類 型 之 使 用 手 冊... 3 一 安 裝 軟 體 套 件 事 前 準 備... 3 二 編 譯 流 程 說 明

Microsoft Word zw

新时期共青团工作实务全书(三十九)

南華大學數位論文


经 济 高 速 增 长 和 其 后 又 比 其 他 发 达 资 本 主 义 国 家 更 为 顺 利 地 克 服 了 石 油 危 机 的 冲 击, 使 日 本 的 市 场 经 济 体 制 在 7 0 ~ 8 0 年 代 赢 得 了 国 际 社 会 的 广 泛 赞 誉 ( 其 间 虽 有 欧 美 国 家

2015 TB-1-06.indd

大连软~1

影視後製全攻略 Premiere Pro After Effects Encore 自序 Adobe Premiere Pro After Effects Encore 2008 Adobe CS Adobe CS5 Adobe CS4 Premiere Pro After Effect

相 惜 033 女 子 受 是 靠 德 行 而 非 美 貌 033 刘 庭 式 与 盲 妻 道 义 人 生 036 什 么 是 爱, 什 么 是 欲 038 相 爱 040 爱 感 觉 是 温 暖 040 爱 言 语 是 正 直 043 爱 心 地 是 无 私 045 爱 行 为 是 成 全 050

untitled

常见问题

Microsoft Word - 放榜用-105無口試放榜電子榜單_NEW_.doc

Microsoft Word - 第1章 Android基本概念.docx

針灸治療膝關節疼痛綜述

团 学 要 闻 我 校 召 开 共 青 团 五 届 九 次 全 委 ( 扩 大 ) 会 议 3 月 17 日, 我 校 共 青 团 五 届 九 次 全 委 ( 扩 大 ) 会 议 在 行 政 办 公 楼 五 楼 会 议 室 举 行, 校 团 委 委 员 各 院 ( 系 ) 团 委 书 记 校 学 生

Microsoft Word - Learn Objective-C.doc

1. 2. Flex Adobe 3.

目录

手册 doc

1 1 大概思路 创建 WebAPI 创建 CrossMainController 并编写 Nuget 安装 microsoft.aspnet.webapi.cors 跨域设置路由 编写 Jquery EasyUI 界面 运行效果 2 创建 WebAPI 创建 WebAPI, 新建 -> 项目 ->

ebook



af9c70ccea1f1950c6732b99b2e51134_ pdf

(TestFailure) JUnit Framework AssertionFailedError JUnit Composite TestSuite Test TestSuite run() run() JUnit

Eclipse C C++, or

最佳实践

镇江市行政审批事项申报材料清单

100學年度資訊處滿意度調查回應表(教師組)

untitled

RunPC2_.doc

今天 年春季号 总 92 期

*

( ) / / / / / / /

(Microsoft Word - 8\244T\244\362\277\337\272]\244W\265L\246W.doc)

Microsoft Word - 專家本色 doc


但, 你 应 该 听 过 我 们 走 在 大 路 上 这 首 歌, 或 许 还 知 道 革 命 人 永 远 是 年 轻 那 支 歌 ; 并 且, 几 乎 可 以 肯 定, 你 在 戴 红 领 巾 的 那 阵, 必 然 唱 过 牛 儿 还 在 山 坡 吃 草, 放 牛 的 却 不 知 道 哪 儿 去

2 临 终 助 念 答 问 序 临 终 关 怀, 由 佛 门 净 宗 古 来 祖 师 大 德 提 倡 助 念 往 生, 现 今 已 渐 为 社 会 大 众 所 重 视, 在 台 湾, 台 大 长 庚 等 各 大 医 院, 也 都 设 有 助 念 室 ; 大 陆 上 许 多 道 场, 也 有 专 为

校园之星

Microsoft Word - 澎湖田調報告-宏達組9804.doc

<4D F736F F F696E74202D FA8BEA861B8EAB7BDBEE3A658BB50C0B3A5CE28B773A6CBA5AB29>


之 原 則 及 國 防 部 訂 頒 國 軍 列 管 國 有 不 動 產 提 供 非 軍 方 單 位 使 用 處 理 原 則 規 定 不 符, 仍 應 以 出 租 方 式 辦 理 惟 可 就 偏 遠 地 區 提 供 官 兵 金 融 水 電 服 務 使 用 部 分, 研 議 降 低 租 金 標 準, 報

chineseall

釋禪波羅蜜次第法門

证券代码: 证券简称:锦江股份 公告编号:【】

1700 装 卸 搬 运 7645 装 卸 搬 运 服 务 2100 建 筑 7410 工 程 服 务 11% 装 卸 搬 运 服 务, 是 指 使 用 装 卸 搬 运 工 具 或 者 人 力 畜 力 将 货 物 在 运 输 工 具 之 间 装 卸 现 场 之 间 或 者 运 输 工 具 与 装 卸

前 言 教 育 无 小 事, 它 成 就 着 学 生 的 未 来 作 为 教 师, 他 们 无 时 无 刻 不 在 关 注 着 学 生 的 成 长 学 生 的 未 来 学 生 就 像 一 朵 含 苞 待 放 的 花 朵, 需 要 老 师 们 的 细 心 呵 护, 给 学 生 需 要 的 东 西, 而

《盗墓笔记》 南派三叔/著

平 凡 足 迹 李 本 川 作 者 为 中 国 科 学 院 海 洋 研 究 所 研 究 员,1935 年 生, 山 东 荣 成 人 我 今 年 63 岁 了 大 前 年 丈 夫 和 儿 子 在 一 个 月 内 先 后 离 开 了 人 世, 女 儿 又 已 出 嫁, 现 在 是 孑 然 一 身 我 是

<CFFBB7D1D5DFD0D0CEAAD1A72E6D7073>

独立学院建设与发展


输入 project name 选择完成

Microsoft Word - 实验一Android开发环境搭建.doc

银 瑞 鸿 注 册 电 气 工 程 ( 供 配 电 ) DG 电 蒋 朝 志 一 级 注 册 结 构 工 程 S 结 构 陈 志 强 一 级 注 册 结 构 工 程 S 结 构 吴 莉 萍 一 级 注 册 建 筑 建 筑 陈

範本檔

(i) (ii) (iii) (iv) 380,000 [ ] , , % % % 5.5% 6.5%

7. 您 的 任 教 年 資 為 : 1-2 年 3-5 年 6-10 年 年 21 年 以 上 8. 您 的 性 別 : 男 女 9. 您 平 時 是 從 哪 裡 獲 得 有 關 防 災 的 知 識 或 相 關 訊 息 ( 可 複 選 )? 電 視 廣 播 電 腦 網 路 學 校 課

エスポラージュ株式会社 住所 : 東京都江東区大島 東急ドエルアルス大島 HP: ******************* * 关于 Java 测试试题 ******

FileMaker 16 ODBC 和 JDBC 指南

4-4

《80后职场新鲜人生存手册》

中 文 摘 要 智 慧 型 手 機 由 於 有 強 大 的 功 能, 以 及 優 渥 的 便 利 性, 還 能 與 網 路 保 持 隨 時 的 鏈 結 與 同 步 更 新, 因 此 深 受 廣 大 消 費 者 喜 愛, 當 然, 手 機 遊 戲 也 成 為 現 代 人 不 可 或 缺 的 娛 樂 之

<453A5CCEC4B5B55C C41CBAAB2F5D4C6BDD3BFDACAB9D3C3CBB5C3F756312E305F E646F63>

Microsoft Word - IDL导出说明.doc

用户指南

Transcription:

文档版本 03 发布日期 2019-01-30 华为技术有限公司

版权所有 华为技术有限公司 2019 保留一切权利 非经本公司书面许可, 任何单位和个人不得擅自摘抄 复制本文档内容的部分或全部, 并不得以任何形式传播 商标声明 和其他华为商标均为华为技术有限公司的商标 本文档提及的其他所有商标或注册商标, 由各自的所有人拥有 注意 您购买的产品 服务或特性等应受华为公司商业合同和条款的约束, 本文档中描述的全部或部分产品 服务或特性可能不在您的购买或使用范围之内 除非合同另有约定, 华为公司对本文档内容不做任何明示或默示的声明或保证 由于产品版本升级或其他原因, 本文档内容会不定期进行更新 除非另有约定, 本文档仅作为使用指导, 本文档中的所有陈述 信息和建议不构成任何明示或暗示的担保 华为技术有限公司 地址 : 深圳市龙岗区坂田华为总部办公楼邮编 :518129 网址 : http://www.huawei.com 客户服务邮箱 : support@huawei.com 客户服务电话 : 4008302118 文档版本 03 (2019-01-30) 版权所有 华为技术有限公司 i

目录 目录 1 Java SDK... 1 1.1 入门指导... 1 1.2 SDK 接口示例... 3 1.3 SDK & API 对应关系...3 2 Python SDK... 5 2.1 入门指导... 5 2.2 SDK 接口示例... 6 2.3 SDK & API 对应关系...6 3 Go SDK...9 3.1 入门指导... 9 3.2 SDK 接口示例... 10 3.3 SDK & API 对应关系...11 4 CSharp SDK... 13 4.1 入门指导... 13 4.2 SDK 接口示例... 14 4.3 SDK & API 对应关系...14 A 修订记录... 16 文档版本 03 (2019-01-30) 版权所有 华为技术有限公司 ii

1 Java SDK 1 Java SDK 1.1 入门指导 环境准备 1. 获取 API 相关文档, 服务的 API 请见 API 参考 访问华为云开放 API 的产品界面, 可获取其他云服务的 API 参考 2. 获取服务的 Endpoint, 请参见地区和终端节点 3. 开通服务 : 登录管理控制台, 选择对应的子服务, 单击右侧的 开通服务 服务开通一次即可, 后续使用时无需再开通 4. 获取华为云账号的 AK/SK 如果之前没有生成过 AK/SK, 可登录华为云 我的凭证 界面, 选择 管理访问密钥 > 新增访问密钥 来获取 5. 已经安装好 JDK,Java SDK 适用于 JDK1.8+ 说明 服务提供的 SDK 暂不支持访问重试, 如果访问异常,SDK 会直接返回本次的请求结果, 所以需要客户端自行建立重试机制 安卓系统使用的 Java SDK 时, 不支持主线程直接调用, 建议使用子线程 SDK 获取和安装 以 Eclipse 为例, 创建 Java 工程后, 执行以下步骤, 导入 JAR 文件到新建的工程中 : 1. 下载 SDK 的 JAR 文件 2. 将下载的 JAR 文件复制到工程文件夹中 3. 在 Eclipse 中打开工程, 右键单击该项工程, 选择 Properties 4. 在弹出的对话框中, 单击 Java Build Path, 然后在 Libraries 页签下单击 Add JARs, 添加下载的 JAR 文件 5. 单击 OK 本文档中涉及的服务使用同一个 JAR 文件 文档版本 03 (2019-01-30) 版权所有 华为技术有限公司 1

1 Java SDK 开始使用 设置参数, 初始化 SDK 客户端, 然后调用 SDK 访问服务的 API // 设置认证参数 String ak = "ak"; String sk = "sk"; String projectid = "projectid"; //Proxy info, 当您需要使用代理才可以访问到服务时, 可在此处增加代理信息 ProxyHostInfo proxyhostinfo = new ProxyHostInfo("proxy ", 8080, "UserName", "Password" ); //Service info String url = "https://face.cn-north-4.myhuaweicloud.com"; String region = "cn-north-4"; AuthInfo authinfo = new AuthInfo(url, region, ak, sk); try (FrsClient frsclient = new FrsClient(authInfo, projectid)) { //try (FrsClient frsclient = new FrsClient(authInfo, projectid, proxyhostinfo)) { // 需使用代理时 // 调用前请在管理控制台开通服务 // 创建人脸集合 String facesetname = "facesetname"; int facesetcapacity = 10000; // 创建人脸集合时, 自定义属性 CreateExternalFields createexternalfields = new CreateExternalFields(); createexternalfields.addfield("testinteger", FieldType.INTEGER); CreateFaceSetResult createfacesetresult = frsclient.getfacesetservice().createfaceset(facesetname, facesetcapacity, createexternalfields); System.out.println(createFaceSetResult.toJSONString()); // 获取人脸集合 GetAllFaceSetResult getallfacesetsresult = frsclient.getfacesetservice().getallfaceset(); System.out.println(getAllFaceSetResult.toJSONString()); // 添加人脸 String imageid = "image1"; File image = new File("data/face.jpg"); byte[] filedata = FileUtils.readFileToByteArray(image); String imagebase64 = Base64.encodeBase64String(fileData); AddExternalFields addexternalfields = new AddExternalFields(); addexternalfields.addfield("testinteger", 123); AddFaceResult addfaceresult = frsclient.getfaceservice().addfacebybase64(facesetname, imageid, imagebase64, addexternalfields); System.out.println(addFaceResult.toJSONString()); // 人脸对比 String image1path = "data/face1.jpg"; String image2path = "data/face2.jpg"; CompareFaceResult comparefaceresult = frsclient.getcompareservice().comparefacebyfile(image1path, image2path); System.out.println(compareFaceResult.toJSONString()); // 人脸检测 String obsurl = "/bucket/face.jpg"; String attr = "0,1,2,3,4,5"; DetectFaceResult detectfaceresult = frsclient.getdetectservice().detectfacebyobsurl(obsurl, attr); System.out.println(detectFaceResult.toJSONString()); } 文档版本 03 (2019-01-30) 版权所有 华为技术有限公司 2

1 Java SDK 1.2 SDK 接口示例 1. 构造服务客户端 String ak = "ak"; String sk = "sk"; String projectid = "projectid"; //Proxy info, 当您需要使用代理才可以访问到服务时, 可在此处增加代理信息 ProxyHostInfo proxyhostinfo = new ProxyHostInfo("proxy", 8080, "UserName", "Password" ); //Service info String url = "https://face.cn-north-4.myhuaweicloud.com"; String region = "cn-north-4"; AuthInfo authinfo = new AuthInfo(url, region, ak, sk); FrsClient frsclient = new FrsClient(authInfo, projectid); //FrsClient frsclient = new FrsClient(authInfo, projectid, proxyhostinfo);// 当您需要代理才可以访问到服务时, 在第三个参数增加代理信息即可 2. 创建人脸集 CreateExternalFields createexternalfields = new CreateExternalFields(); createexternalfields.addfield("testinteger", FieldType.INTEGER); CreateFaceSetResult createfacesetresult = frsclient.getfacesetservice().createfaceset(facesetname, facesetcapacity, createexternalfields); 3. 添加人脸 String imageid = "image1"; File image = new File("data/face.jpg"); byte[] filedata = FileUtils.readFileToByteArray(image); String imagebase64 = Base64.encodeBase64String(fileData); AddExternalFields addexternalfields = new AddExternalFields(); addexternalfields.addfield("testinteger", 123); AddFaceResult addfaceresult = frsclient.getfaceservice().addfacebybase64(facesetname, imageid, imagebase64, addexternalfields); 4. 调用人脸检测服务 String obsurl = "/bucket/face.jpg"; String attr = "0,1,2,3,4,5"; DetectFaceResult detectfaceresult = frsclient.getdetectservice().detectfacebyobsurl(obsurl, attr); 1.3 SDK & API 对应关系 接口方法 API CompareServic e comparefacebybas e64 comparefacebyfile comparefacebyobs Url POST /v1/{project_id}/face-compare DetectService detectfacebybase64 POST /v1/{project_id}/face-detect detectfacebyfile detectfacebyobsurl 文档版本 03 (2019-01-30) 版权所有 华为技术有限公司 3

1 Java SDK 接口方法 API FaceService addfacebybase64 POST /v1/{project_id}/face-sets/ addfacebyfile {face_set_name}/faces addfacebyobsurl getfaces getface deletefacebyfaceid deletefacebyextern alimageid deletefacebyfieldid GET /v1/{project_id}/face-sets/ {face_set_name}/faces?offset=xxx&limit=xxx GET /v1/{project_id}/face-sets/ {face_set_name}/faces?face_id={face_id} {face_set_name}/faces? external_image_id=imageid {face_set_name}/faces?face_id=faceid {face_set_name}/faces?id=home FaceSetService createfaceset POST /v1/{project_id}/face-sets LiveDetectServ ice SearchService getallfacesets getfaceset deletefaceset livedetectbybase64 livedetectbyfile livedetectbyobsurl searchfacebybase6 4 searchfacebyfile searchfacebyobsur l searchfacebyfaceid GET /v1/{project_id}/face-sets GET /v1/{project_id}/face-sets/{face_set_name} {face_set_name} POST /v1/{project_id}/live-detect POST /v1/{project_id}/face-sets/ {face_set_name}/search 文档版本 03 (2019-01-30) 版权所有 华为技术有限公司 4

2 Python SDK 2 Python SDK 2.1 入门指导 环境准备 1. 获取 API 相关文档, 服务的 API 请见 API 参考 访问华为云开放 API 的产品界面, 可获取其他云服务的 API 参考 2. 获取服务的 Endpoint, 请参见地区和终端节点 3. 开通服务 : 登录管理控制台, 选择对应的子服务, 单击右侧的 开通服务 服务开通一次即可, 后续使用时无需再开通 4. 获取华为云账号的 AK/SK 如果之前没有生成过 AK/SK, 可登录华为云 我的凭证 界面, 选择 管理访问密钥 > 新增访问密钥 来获取 5. 已经安装好 Python 环境,Python SDK 适用于 Python2.7 Python3.6 SDK 获取和安装 开始使用 说明 服务提供的 SDK 暂不支持访问重试, 如果访问异常,SDK 会直接返回本次的请求结果, 所以需要客户端自行建立重试机制 1. 下载服务的 Python SDK 并解压 2. 下载和安装 setuptools 工具 3. 命令行切换到 Python SDK 解压目录 4. 在 SDK 目录中, 执行 Python setup.py install 命令安装 Python SDK 到开发环境, 或者将.py 文件直接引入项目 说明 Python 编程时要引用 frsclient 文件夹下所有的文件 :from frsclient import * 设置参数, 初始化 SDK 客户端, 然后调用 SDK 访问服务的 API 文档版本 03 (2019-01-30) 版权所有 华为技术有限公司 5

2 Python SDK ak = "ak" sk = "sk" project_id = "projectid" end_point = " https://face.cn-north-4.myhuaweicloud.com" proxy = {"http": "http://127.0.0.1:1234", "https": "http://127.0.0.1:1234"} auth_info = AuthInfo(ak=ak, sk=sk, end_point=end_point) frs_client = FrsClient(auth_info=auth_info, project_id=project_id) # frs_client = FrsClient(auth_info=auth_info, project_id=project_id, proxies=proxy) # 需要使用代理访问云服务时配置 // 人脸对比 image1_path = "" image2_path = "" cs = frs_client.get_compare_service() res = cs.compare_face_by_file(image1_path, image2_path) print res.get_eval_result() // 活体检测 lds = frs_client.get_live_detect_service() video_file = "data/video.mp4" actions = "1" res = lds.live_detect_by_file(video_file, actions) print res.get_eval_result() 2.2 SDK 接口示例 1. 构造服务客户端 ak = "ak" sk = "sk" project_id = "projectid" end_point = " https://face.cn-north-4.myhuaweicloud.com" proxy = {"http": "http://127.0.0.1:1234", "https": "http://127.0.0.1:1234"} auth_info = AuthInfo(ak=ak, sk=sk, end_point=end_point) frs_client = FrsClient(auth_info=auth_info, project_id=project_id) # frs_client = FrsClient(auth_info=auth_info, project_id=project_id, proxies=proxy) # 当您需要代理才可以访问到服务时, 在第三个参数增加代理信息即可 2. 创建人脸集 fss = frs_client.get_face_set_service() external_fields = "{\"timestamp\":{\"type\" : \"long\"},\"id\":{\"type\":\"string\"},\"number \":{\"type\":\"integer\"}}" ret = fss.create_face_set("facesetname", 10000, external_fields) 3. 添加人脸 fs = frsclient.get_face_service() external_fields = "{\"timestamp\": 12,\"id\": \"home\"}" res = fs.add_face_by_obs_url("facesetname", "/obs/image.jpg", "externalimageid", external_fields) 4. 人脸检测 ds = frs.get_detect_service() res = ds.detect_face_by_file("imagepath", "0,1,2,3") 2.3 SDK & API 对应关系 接口方法 API CompareServic e compare_face_by_b ase64 POST /v1/{project_id}/face-compare 文档版本 03 (2019-01-30) 版权所有 华为技术有限公司 6

2 Python SDK 接口方法 API compare_face_by_fi le compare_face_by_o bs_url DetectService detect_face_by_base 64 detect_face_by_file detect_face_by_obs _url POST /v1/{project_id}/face-detect FaceService add_face_by_base64 POST /v1/{project_id}/face-sets/ add_face_by_file {face_set_name}/faces add_face_by_obs_ur l get_faces get_face delete_face_by_face _id delete_face_by_exte rnal_image_id delete_face_by_field _id GET /v1/{project_id}/face-sets/ {face_set_name}/faces?offset=xxx&limit=xxx GET /v1/{project_id}/face-sets/ {face_set_name}/faces?face_id={face_id} {face_set_name}/faces? external_image_id=imageid {face_set_name}/faces?face_id=faceid {face_set_name}/faces?id=home FaceSetService create_face_set POST /v1/{project_id}/face-sets LiveDetectServ ice SearchService get_all_face_sets get_face_set delete_face_set live_detect_by_base 64 live_detect_by_file live_detect_by_obs_ url search_face_by_bas e64 GET /v1/{project_id}/face-sets GET /v1/{project_id}/face-sets/{face_set_name} {face_set_name} POST /v1/{project_id}/live-detect POST /v1/{project_id}/face-sets/ {face_set_name}/search 文档版本 03 (2019-01-30) 版权所有 华为技术有限公司 7

2 Python SDK 接口方法 API search_face_by_file search_face_by_obs _url search_face_by_face _id 文档版本 03 (2019-01-30) 版权所有 华为技术有限公司 8

3 Go SDK 3 Go SDK 3.1 入门指导 环境准备 1. 获取 API 相关文档, 服务的 API 请见 API 参考 访问华为云开放 API 的产品界面, 可获取其他云服务的 API 参考 2. 获取服务的 Endpoint, 请参见地区和终端节点 3. 开通服务 : 登录管理控制台, 选择对应的子服务, 单击右侧的 开通服务 服务开通一次即可, 后续使用时无需再开通 4. 获取华为云账号的 AK/SK 如果之前没有生成过 AK/SK, 可登录华为云 我的凭证 界面, 选择 管理访问密钥 > 新增访问密钥 来获取 5. 已经安装好 Go, 并设置好 Go 语言环境变量 SDK 获取和安装 开始使用 说明 服务提供的 SDK 暂不支持访问重试, 如果访问异常,SDK 会直接返回本次的请求结果, 所以需要客户端自行建立重试机制 1. 下载服务的 Go SDK 并解压 2. 使用 Eclipse 新建 Go 工程, 将 Go SDK 文件夹下的全部内容拷贝至新建工程中的文件夹下 3. 右键单击建好的 Go 工程, 运行弹出菜单中的 Build Project 命令编译工程并等待编译完成 设置参数, 初始化 SDK 客户端, 然后调用 SDK 访问服务的 API authinfo := param.authinfo{endpoint: "https://face.cn-north-4.myhuaweicloud.com", Ak: "ak", Sk: "sk"} frsclient := service.newfrsclient(&authinfo, "projectid") 文档版本 03 (2019-01-30) 版权所有 华为技术有限公司 9

3 Go SDK //proxyinfo := param.proxyhostinfo{proxy: "http://127.0.0.1:8080"} //frsclient := service.newfrsclientwithproxy(&authinfo, "projectid", &proxyinfo)// 当您需要代理才可以访问到服务时, 在第三个参数增加代理信息即可 // 人脸对比 compareresult, err := frsclient.getcompareservice().comparefacebyfile("image1path", "image2path") if nil!= err { fmt.println(err.error()) } else { fmt.println(compareresult) } // 人脸检测 detectresult, err2 := frsclient.getdetectservice().detectfacebyobsurlwithattr("obsurl", "0,1,2") if nil!= err2 { fmt.println(err2.error()) } else { fmt.println(detectresult) } 3.2 SDK 接口示例 1. 构造服务客户端 authinfo := param.authinfo{endpoint: "https://face.cn-north-4.myhuaweicloud.com", Ak: "ak", Sk: "sk"} frsclient := service.newfrsclient(&authinfo, "projectid") //proxyinfo := param.proxyhostinfo{proxy: "http://127.0.0.1:8080"} //frsclient := service.newfrsclientwithproxy(&authinfo, "projectid", &proxyinfo)// 当您需要代理才可以访问到服务时, 在第三个参数增加代理信息即可 2. 创建人脸集 externalfields := param.newcreateexternalfields() externalfields.addfield("testinteger", param.integer) result, err := frsclient.getfacesetservice().createfacesetwithextfields("facesetname", 10000, externalfields) if nil!= err { fmt.println(err.error()) } else { fmt.println(result) } 3. 添加人脸 externalfields := param.newaddexternalfields() externalfields.addfield("testinteger", 123) result, err := frsclient.getfaceservice().addfacebyfilefull("facesetname", "externalimageid", "imagepath", externalfields) if nil!= err { fmt.println(err.error()) } else { fmt.println(result) } 4. 人脸检测 detectresult, err := frsclient.getdetectservice().detectfacebyobsurlwithattr("/obs/ image.jpg", "0,1,2") if nil!= err { fmt.println(err.error()) } else { fmt.println(detectresult) } 文档版本 03 (2019-01-30) 版权所有 华为技术有限公司 10

3 Go SDK 3.3 SDK & API 对应关系 接口方法 API CompareServic e DetectService CompareFaceByBas e64 CompareFaceByFile CompareFaceByObs Url DetectFaceByBase6 4 DetectFaceByFile DetectFaceByObsUr l POST /v1/{project_id}/face-compare POST /v1/{project_id}/face-detect FaceService AddFaceByBase64 POST /v1/{project_id}/face-sets/ AddFaceByFile {face_set_name}/faces AddFaceByObsUrl GetFaces GetFace DeleteFaceByFaceId DeleteFaceByExtern alimageid DeleteFaceByFieldI d GET /v1/{project_id}/face-sets/ {face_set_name}/faces?offset=xxx&limit=xxx GET /v1/{project_id}/face-sets/ {face_set_name}/faces?face_id={face_id} {face_set_name}/faces? external_image_id=imageid {face_set_name}/faces?face_id=faceid {face_set_name}/faces?id=home FaceSetService CreateFaceSet POST /v1/{project_id}/face-sets LiveDetectServ ice GetAllFaceSets GetFaceSet DeleteFaceSet LiveDetectByBase6 4 LiveDetectByFile GET /v1/{project_id}/face-sets GET /v1/{project_id}/face-sets/{face_set_name} {face_set_name} POST /v1/{project_id}/live-detect 文档版本 03 (2019-01-30) 版权所有 华为技术有限公司 11

3 Go SDK 接口方法 API LiveDetectByObsUr l SearchService SearchFaceByBase6 4 SearchFaceByFile SearchFaceByObsU rl SearchFaceByFaceI d POST /v1/{project_id}/face-sets/ {face_set_name}/search 文档版本 03 (2019-01-30) 版权所有 华为技术有限公司 12

4 CSharp SDK 4 CSharp SDK 4.1 入门指导 环境准备 1. 获取 API 相关文档, 服务的 API 请见 API 参考 访问华为云开放 API 的产品界面, 可获取其他云服务的 API 参考 2. 获取服务的 Endpoint, 请参见地区和终端节点 3. 开通服务 : 登录管理控制台, 选择对应的子服务, 单击右侧的 开通服务 服务开通一次即可, 后续使用时无需再开通 4. 获取华为云账号的 AK/SK 如果之前没有生成过 AK/SK, 可登录华为云 我的凭证 界面, 选择 管理访问密钥 > 新增访问密钥 来获取 5. 已经安装好.net 开发环境 说明 服务提供的 SDK 暂不支持访问重试, 如果访问异常,SDK 会直接返回本次的请求结果, 所以需要客户端自行建立重试机制 SDK 获取和安装 开始使用 下载 CSharp SDK 的源码 设置参数, 初始化 SDK 客户端, 然后调用 SDK 访问服务的 API AuthInfo authinfo = new AuthInfo("https://face.cn-north-4.myhuaweicloud.com", "ak", "sk"); FrsClient frsclient = new FrsClient(authInfo, "project id"); //ProxyHostInfo proxy := new ProxyHostInfo("host", 8080); //FrsClient frsclient = new FrsClient (authinfo, "projectid", proxy); // 当您需要代理才可以访问到服务时, 在第三个参数增加代理信息即可 // 人脸对比 CompareFaceResult comparefaceresult = frsclient.getcompareservice().comparefacebyurl("/obs/1.jpg", "/obs/1.jpg"); 文档版本 03 (2019-01-30) 版权所有 华为技术有限公司 13

4 CSharp SDK Console.WriteLine(compareFaceResult.GetJsonString()); comparefaceresult = frsclient.getcompareservice().comparefacebyfile("/resource/1.jpeg", "/resource/ 1.jpeg"); Console.WriteLine(compareFaceResult.GetJsonString()); // 人脸检测 DetectFaceResult detectfaceresult = frsclient.getdetectservice().detectfacebyurl("/obs/1.jpg", "0,1,2"); Console.WriteLine(detectFaceResult.GetJsonString()); DetectFaceResult detectfaceresult2 = frsclient.getdetectservice().detectfacebyfile("/resource/ 1.jpeg", "1,2"); Console.WriteLine(detectFaceResult2.GetJsonString()); 4.2 SDK 接口示例 1. 构造服务客户端 AuthInfo authinfo = new AuthInfo("https://face.cn-north-4.myhuaweicloud.com", "ak", "sk"); FrsClient frsclient = new FrsClient(authInfo, "project id"); //ProxyHostInfo proxy := new ProxyHostInfo("host", 8080); //FrsClient frsclient = new FrsClient (authinfo, "projectid", proxy);// 当您需要代理才可以访问到服务时, 在第三个参数增加代理信息即可 2. 创建人脸集 CreateExternalFields createexternalfields = new CreateExternalFields(); createexternalfields.addfield("testint", FieldType.INTEGER); createexternalfields.addfield("teststr", FieldType.STRING); CreateFaceSetResult createfacesetresult = frsclient.getfacesetservice().createfaceset("face_set_name_test", 10000, createexternalfields); Console.WriteLine(createFaceSetResult.GetJsonString()); 3. 添加人脸 AddExternalFields addexternalfields = new AddExternalFields(); addexternalfields.addfield("testint", 1); addexternalfields.addfield("teststr", "str"); AddFaceResult addfaceresult = frsclient.getfaceservice().addfacebyfile("face_set_name_test", "/resource/3.png", addexternalfields); Console.WriteLine(addFaceResult.GetJsonString()); 4. 人脸检测 DetectFaceResult detectfaceresult = frsclient.getdetectservice().detectfacebyurl("/obs/ 1.jpg", "0,1,2"); Console.WriteLine(detectFaceResult.GetJsonString()); DetectFaceResult detectfaceresult2 = frsclient.getdetectservice().detectfacebyfile("/ resource/1.jpeg", "1,2"); Console.WriteLine(detectFaceResult2.GetJsonString()); 4.3 SDK & API 对应关系 接口方法 API CompareServic e CompareFaceByBase64 CompareFaceByFile CompareFaceByUrl POST /v1/{project_id}/face-compare DetectService DetectFaceByBase64 POST /v1/{project_id}/face-detect DetectFaceByFile DetectFaceByUrl 文档版本 03 (2019-01-30) 版权所有 华为技术有限公司 14

4 CSharp SDK 接口方法 API FaceService AddFaceByBase64 POST /v1/{project_id}/face-sets/ AddFaceByFile {face_set_name}/faces AddFaceByUrl GetFaces GetFace DeleteFaceByFaceId DeleteFaceByExternalIma geid DeleteFaceByFieldId GET /v1/{project_id}/face-sets/ {face_set_name}/faces? offset=xxx&limit=xxx GET /v1/{project_id}/face-sets/ {face_set_name}/faces?face_id={face_id} {face_set_name}/faces? external_image_id=imageid {face_set_name}/faces?face_id=faceid {face_set_name}/faces?id=home FaceSetService CreateFaceSet POST /v1/{project_id}/face-sets LiveDetectServ ice GetAllFaceSets GetFaceSet DeleteFaceSet LiveDetectByBase64 LiveDetectByFile LiveDetectByUrl GET /v1/{project_id}/face-sets GET /v1/{project_id}/face-sets/ {face_set_name} {face_set_name} POST /v1/{project_id}/live-detect SearchService SearchFaceByBase64 POST /v1/{project_id}/face-sets/ SearchFaceByFile {face_set_name}/search SearchFaceByObsUrl SearchFaceByFaceId 文档版本 03 (2019-01-30) 版权所有 华为技术有限公司 15

A 修订记录 A 修订记录 发布日期 修改说明 2019-01-30 第三次正式发布,Python SDK 样例与 SDK 代码风格同步 修改如下章节 : 入门指导 SDK 接口示例 SDK & API 对应关系 2018-12-28 第二次正式发布, 新增 CSharp SDK 2018-12-12 第一次正式发布 文档版本 03 (2019-01-30) 版权所有 华为技术有限公司 16