调用方式

调用AI服务相关的API接口有两种调用方式,两种不同的调用方式采用相同的接口URL。

区别在于 请求方式鉴权方法 不一样,请求参数和返回结果一致。

调用方式一

请求URL数据格式

向API服务地址使用POST发送请求,必须在URL中带上参数:

access_token:必须参数,参考“Access Token获取”。

注意:access_token的有效期为30天,切记需要每30天进行定期更换,或者每次请求都拉取新token。

POST中参数按照API接口说明调用即可。

例如菜品识别API,使用HTTPS POST发送:

https://aip.baidubce.com/rest/2.0/image-classify/v2/dish?access_token=24.f9ba9c5241b67688bb4adbed8bc91dec.2592000.1485570332.282335-8574074

获取access_token示例代码

(参见线上文档)

说明:方式一鉴权使用的Access_token必须通过API Key和Secret Key获取。

调用方式二

请求头域内容

在请求的HTTP头域中包含以下信息:

  • host(必填)
  • x-bce-date (必填)
  • x-bce-request-id(选填)
  • authorization(必填)
  • content-type(必填)
  • content-length(选填)

作为示例,以下是一个标准的人脸识别的请求头域内容:

POST /rest/2.0/face/v1/detect 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/46bd9968a6194b4bbdf0341f2286ccce/2015-03-24T13:02:00Z/1800/host;x-bce-date/994014d96b0eb26578e039fa053a4f9003425da4bfedf33f4790882fb4c54903

说明:方式二鉴权使用的API认证机制authorization必须通过百度智能云的AK/SK生成。