百度智能云飞桨EasyDL零门槛AI开发平台 - 图像物体检测模型发布 - API调用文档
文档简介:
本文档主要说明定制化模型发布后获得的API如何使用,如有疑问可以通过以下方式联系我们:
在百度智能云控制台内提交工单。
进入EasyDL社区交流 ,与其他开发者进行互动。
接口描述:
基于自定义训练出的物体检测模型,实现定制图像识别。
本文档主要说明定制化模型发布后获得的API如何使用,如有疑问可以通过以下方式联系我们:
- 在百度智能云控制台内提交工单
- 进入EasyDL社区交流 ,与其他开发者进行互动
接口描述
基于自定义训练出的物体检测模型,实现定制图像识别。
接口鉴权
1、在EasyDL控制台创建应用
2、应用详情页获取AK SK
请求说明
请求示例
HTTP 方法:POST
请求URL: 请首先进行自定义模型训练,完成训练后申请上线,上线成功后可在服务列表中查看并获取url。
URL参数:
参数 | 值 |
---|---|
access_token | 通过API Key和Secret Key获取的access_token,参考“Access Token获取” |
Header如下:
参数 | 值 |
---|---|
Content-Type | application/json |
注意:如果出现336001的错误码很可能是因为请求方式错误,与其他图像识别服务不同的是定制化图像识别服务以json方式请求。
Body请求示例:
{
"image": "<base64数据>"
}
Body中放置请求参数,参数详情如下:
请求参数
参数 | 是否必选 | 类型 | 可选值范围 | 说明 |
---|---|---|---|---|
image | 是 | string | - | 图像数据,base64编码,要求base64编码后大小不超过4M,最短边至少15px,最长边最大4096px,支持jpg/png/bmp格式 注意请去掉头部 |
threshold | 否 | number | - | 默认值为推荐阈值,请在我的模型列表-模型效果查看推荐阈值 |
url | 否 | string | - | 如果请求URL中增加“input_type=url”,则该参数必传,否则“image”参数必传。参数内容为URL string,用户需确保该string是有效的图片URL,否则会下载失败 |
请求代码示例
提示一:使用示例代码前,请记得替换其中的示例Token、图片地址或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 = '【接口地址】?access_token=' . $token;
$bodys = "{\"image\":\"sfasq35sadvsvqwr5q...\"}" $res = request_post($url, $bodys); var_dump($res);
返回说明
返回参数
字段 | 是否必选 | 类型 | 说明 |
---|---|---|---|
log_id | 是 | number | 唯一的log id,用于问题定位 |
results | 否 | array(object) | 识别结果数组 |
+name | 否 | string | 分类名称 |
+score | 否 | number | 置信度 |
+location | 否 | ||
++left | 否 | number | 检测到的目标主体区域到图片左边界的距离 |
++top | 否 | number | 检测到的目标主体区域到图片上边界的距离 |
++width | 否 | number | 检测到的目标主体区域的宽度 |
++height | 否 | number | 检测到的目标主体区域的高度 |
错误示例
需要重新获取新的Access Token再次请求即可。
错误码 | 错误信息 | 描述 |
---|---|---|
1 | Unknown error | 服务器内部错误,请再次请求, 如果持续出现此类错误,请在百度云控制台内提交工单反馈 |
2 | Service temporarily unavailable | 服务暂不可用,请再次请求, 如果持续出现此类错误,请在百度云控制台内提交工单反馈 |
3 | Unsupported openapi method | 调用的API不存在,请检查后重新尝试 |
4 | Open api request limit reached | 集群超限额 |
6 | No permission to access data | 无权限访问该用户数据 |
13 | Get service token failed | 获取token失败 |
14 | IAM Certification failed | IAM鉴权失败 |
15 | app not exsits or create failed | 应用不存在或者创建失败 |
17 | Open api daily request limit reached | 每天请求量超限额,已上线计费的接口,请直接在控制台开通计费,调用量不受限制,按调用量阶梯计费;未上线计费的接口,请在百度云控制台内提交工单反馈 |
18 | Open api qps request limit reached | QPS超限额,已上线计费的接口,请直接在控制台开通计费,调用量不受限制,按调用量阶梯计费;未上线计费的接口,请在百度云控制台内提交工单反馈 |
19 | Open api total request limit reached | 请求总量超限额,已上线计费的接口,请直接在控制台开通计费,调用量不受限制,按调用量阶梯计费;未上线计费的接口,请在百度云控制台内提交工单反馈 |
100 | Invalid parameter | 无效的access_token参数,请检查后重新尝试 |
110 | Access token invalid or no longer valid | access_token无效 |
111 | Access token expired | access token过期 |
336000 | Internal error | 服务器内部错误,请再次请求, 如果持续出现此类错误,请在百度云控制台内提交工单反馈 |
336001 | Invalid Argument | 入参格式有误,比如缺少必要参数、图片base64编码错误等等,可检查下图片编码、代码格式是否有误。有疑问请在百度云控制台内提交工单反馈 |
336002 | JSON不合法 | 入参格式或调用方式有误,比如缺少必要参数或代码格式有误。有疑问请在百度云控制台内提交工单反馈 |
336003 | Base64解码失败 | 图片/音频/文本格式有误或base64编码有误,请根据接口文档检查格式,base64编码请求时注意要去掉头部。有疑问请在百度云控制台内提交工单反馈 |
336004 | 输入文件大小不合法 | 图片超出大小限制,图片限4M以内,请根据接口文档检查入参格式,有疑问请在百度云控制台内提交工单反馈 |
336005 | 图片解码失败 | 图片编码错误(非jpg,bmp,png等常见图片格式),请检查并修改图片格式 |
336006 | 缺失必要参数 | image字段缺失(未上传图片) |
336100 | model temporarily unavailable | 遇到该错误码请等待1分钟后再次请求,可恢复正常,若反复重试依然报错或有疑问请在百度云控制台内提交工单反馈 |