百度智能云飞桨EasyDL零门槛AI开发平台零售行业版 - 翻拍识别服务API调用方法
文档简介：
本文档主要说明如何使用翻拍识别API，如有疑问可以通过以下方式联系我们：
在百度云控制台内提交工单，咨询问题类型请选择人工智能服务。
加入EasyDL官方QQ群（群号:1009661589）联系群管。
接口鉴权：
进入EasyDL零售版的百度云控制台应用列表页面，如下图所示：
咨询热线：400-826-7010，为您提供专业的售前咨询，让您快速了解云产品，助您轻松上云！
微信咨询
免费试用、价格特惠
简介
本文档主要说明如何使用翻拍识别API，如有疑问可以通过以下方式联系我们：
- 在百度云控制台内提交工单，咨询问题类型请选择人工智能服务
- 加入EasyDL官方QQ群（群号:1009661589）联系群管
接口鉴权
- 进入EasyDL零售版的百度云控制台应用列表页面，如下图所示：
- 如果还未创建应用，请点击「创建应用」按钮进行创建。创建应用后，参考鉴权参考文档，使用API Key(AK)和Secret Key(SK)获取access_token
接口调用
请求说明
请求示例
HTTP 方法：POST
商品陈列翻拍识别请求URL： https://aip.baidubce.com/rpc/2.0/easydl/v1/retail/recapture
URL参数：
| 参数 | 值 |
|---|---|
| access_token | 通过API Key和Secret Key获取的access_token,参考“Access Token获取” |
Header如下：
| 参数 | 值 |
|---|---|
| Content-Type | application/json |
注意：如果出现336001和336002的错误码很可能是因为请求方式错误，与其他图像识别服务不同的是定制化图像识别服务以json方式请求。
Body请求示例：
{
"image": "<base64数据>"
}
Body中放置请求参数，参数详情如下：
请求参数
| 参数 | 是否必选 | 类型 | 可选值范围 | 说明 |
|---|---|---|---|---|
| image | 是 | string | - | 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式 注意请去掉头部 |
提示：image参数中“去掉头部”指的是图片经base64编码后的头部信息「data:image/jpeg;base64,」，如下图所示：
<?php /**
* 发起http post请求(REST API), 并获取REST请求的结果
* @param string $url
* @param string $param
* @return - http response body if succeeds, else false.
*/ function request_post($url = '', $param = '') { if (empty($url)
|| empty($param)) { return false; } $postUrl = $url; $curlPost = $param;
// 初始化curl $curl = curl_init(); curl_setopt($curl, CURLOPT_URL, $postUrl);
curl_setopt($curl, CURLOPT_HEADER, 0); // 要求结果为字符串且输出到屏幕上
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1); curl_setopt($curl,
CURLOPT_SSL_VERIFYPEER, false); // post提交方式 curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, $curlPost); // 运行curl $data = curl_exec($curl);
curl_close($curl); return $data; } $token = '[调用鉴权接口获取的token]';
$url = 'https://aip.baidubce.com/rpc/2.0/easydl/v1/retail/recapture?access_token='
. $token; $bodys = "{\"image\":\"sfasq35sadvsvqwr5q...\"}"
$res = request_post($url, $bodys); var_dump($res);
返回说明
返回参数
| 字段 | 是否必选 | 类型 | 说明 |
|---|---|---|---|
| log_id | 是 | number | 唯一的log id，用于问题定位 |
| results | 否 | array(object) | 分类结果数组 |
| +name | 否 | string | 分类名称，结果会返回“recapture”和“original”两类，recapture为翻拍，original为原图。 |
| +score | 否 | number | 置信度，分别返回“recapture”和“original”两类的置信度 |
建议翻拍判定方法
设定一个判定为翻拍图片的阈值，即如果recapture的score大于这个值，则认为这张图片是翻拍。通常有两中对应的业务模式：
注：以下数值均为建议值，实际应用的阈值请结合业务实际情况和实测结果进行设定
- 业务里查翻拍的原则是宁可错杀一千，也不愿错放一个的，那么可以把认为是翻拍的阈值放在0.8~0.95。
- 业务里查翻拍的原则是允许错放过一些翻拍的图片，但是查到的一定要对，那么可以把认为是翻拍的阈值放在0.98甚至0.99。
