文档简介:
请求格式
POST方式调用
注意:Content-Type为application/x-www-form-urlencoded,然后通过urlencode格式化请求体。
返回格式
JSON格式
请求限制
请求图片需经过base64编码及urlencode后传入:图片的base64编码指将一副图片数据编码成一串字符串,使用该字符串代替图像地址。您可以首先得到图片的二进制,然后去掉编码头后再进行urlencode。
注意:
- 图片的base64编码是不包含图片头的,如(data:image/jpg;base64,);
- 使用 Postman 工具或 Python、PHP 等请求库会自动进行 urlencode,无需自行处理。
请求格式支持:PNG、JPG、JPEG、BMP、TIFF、PNM、WebP
接口名称 | 图片编码后大小限额 |
---|---|
百度文字识别所有接口的图像大小限制 | base64编码urlencode后大小不超过4M,最短边至少15px,最长边最大4096px |
调用方式
调用AI服务相关的API接口有两种调用方式,两种不同的调用方式采用相同的接口URL。
区别在于请求方式和鉴权方法不一样,请求参数和返回结果一致。
【如果您对于使用API调用的方式很陌生,您可以参见:【只要10分钟 快速掌握文字识别】 教程】
调用方式一
请求URL数据格式
向API服务地址使用POST发送请求,必须在URL中带上参数:
access_token: 必须参数,参考“Access Token获取”。
注意:access_token的有效期为30天,需要每30天进行定期更换;
POST中参数按照API接口说明调用即可。
例如文字识别API,使用HTTPS POST发送:
https://aip.baidubce.com/rest/2.0/ocr/v1/general?access_token=24.f9ba9c5241b
67688bb4adbed8bc91dec.2592000.1485570332.282335-8574074
获取access_token示例代码
#!/bin/bash curl -i -k 'https://aip.baidubce.com/oauth/2.0/token?
grant_type=client_credentials&client_id=【百度云应用的AK】&client_secret=【百度云应用的SK】'
说明:方式一鉴权使用的Access_token必须通过API Key和Secret Key获取。
调用方式二
请求头域内容
在请求的HTTP头域中包含以下信息:
- host(必填)
- x-bce-date (必填)
- x-bce-request-id(选填)
- authorization(必填)
- content-type(必填)
- content-length(选填)
作为示例,以下是一个标准的文字识别的请求头域内容:
POST /rest/2.0/ocr/v1/accurate_basic HTTP/1.1 accept-encoding: gzip,
deflate x-bce-date: 2015-03-24T13:02:00Z connection: keep-alive accept:
*/* host: aip.baidubce.com x-bce-request-id: 73c4e74c-3101-4a00-bf44-fe246959c05e
content-type: application/x-www-form-urlencoded authorization: bce-auth-v1/46bd9968a
6194b4bbdf0341f2286ccce/2015-03-24T13:02:00Z/1800/host;x-bce-date/994014d96b0eb26578
e039fa053a4f9003425da4bfedf33f4790882fb4c54903
说明:方式二鉴权使用的API认证机制authorization必须通过百度云的AK/SK生成。