App管理系统 与 命令行工具

App管理系统

Face++开发者页面中,点击顶端导航栏“我的应用”5,即是App管理系统。

3

 选择任意一个应用,点击“管理”,进入该应用的管理界面。

6

 

各个模块功能如下:

  • 应用描述:查看应用基本信息、重置API_Secret。
  • API调用记录:显示应用被调用的次数,包括如人脸检测(detect)等请求。
  • 信息修改:修改应用信息,包括重命名、填写更详细的信息,以及修改应用类型等。注意此处不可修改服务器类型。
  • App后台管理:展现通过该应用创建过的Groups和Facesets,内含Person,Face等信息。了解更多请移步核心概念
  • 删除:删除该应用。

命令行工具

本工具基于Python语言,但是对使用者没有任何语言要求。

为了更方便能够测试和使用Face++的API,我们提供了一套基于Python的命令行交互工具(点击这里下载)。

如何使用

  1. 注册Face++账号,在开发者首页点击“创建应用”。您将在创建完成后,获得该应用的 API_Key 与 API_Secret。
  2. 下载并解压facepp_cmdtool, 解压后facepp_cmdtool内包含两个目录Python与Win32。
    • 对于Windows用户, 将App的API_Key与API_Key写入win32/apikey.cfg文件中,运行win32/cmdtool.exe;
    • 对于Linux/Mac OS用户, 将App的API_Key与API_Key写入python/apikey.cfg文件中,在终端中cd到python目录下, 运行sh run.sh
    • 若您还有疑问,请查阅Python环境部署
  3. 启动后如下图所示,即可在交互式命令行中输入命令操作Face++ API.

cmdtool_start

通过facepp_cmdtool进行Face++ API交互

在facepp_cmdtool中,我们可以通过简单的命令对Face++ API进行操作。调用的方式为:

    api.API_Category.API_Call([Parameter_Name1 = Parameter_Value1, Parameter_Name2 = Parameter_Value2, ...])

几个典型的调用如下:

    api.detection.detect(url = 'http://faceplusplus.com/2014/01/2.jpg')
    api.detection.detect(img = File(r'/tmp/test.jpg')) #通过File可以直接检测本地图片
    api.person.create(person_name = 'Bob')
    api.info.get_group_list()

下图为一个典型调用(使用/detection/detect检测本地图片中的人脸):
cmdtool_detectfile

附加功能1: 自动补全

为了使cmdtool使用更方便,我们建议linux/mac os用户安装IPython (对于Windows用户, IPython已经在工具包中包括)。此时使用facepp_cmdtool,可以使用自动补全功能。通过按Tab键,命令行将提供自动补全和提示。如下图所示:

cmdtool_auto

附加功能2: 结合Python脚本

该命令行交互工具本质是一个Python脚本,因此用户也可以在交互过程中直接结合Python程序,使得此工具更强大。api命令调用的返回结果是Python中的一个dictionary对象,结合返回结果可以让许多操作变简化。下面是两个调用示例:

cmdtool_2 

cmdtool_3