资讯 社区 文档
技术能力
语音技术
文字识别
人脸与人体
图像技术
语言与知识
视频技术

获取access_token

功能介绍

调用本文接口获取access_token,作为调用接口的访问凭证。

注意事项

  • 本文接口适用于使用访问凭证access_token鉴权调用API流程。
  • access_token默认有效期30天,单位是秒,生产环境注意在过期前及时重新调用获取。
  • 调用本文接口,需使用应用API Key、Secret Key;调用接口前,请确保已有千帆ModelBuilder应用,如无请创建千帆ModelBuilder应用
  • 请勿将API Key、Secret Key以及生成的Access token与他人共享或硬编码到APP及终端,为保护您的资源安全,平台可能会针对恶意滥用token进行禁用。

在线调试

通过以下方式快速体验调试获取access_token接口。

  • 方式一:使用百度智能云在线调试平台

百度智能云在线调试平台-示例代码中心快速调试接口,查看在线调用的请求内容和返回结果、示例代码等。

  • 方式二:使用网页调试工具

使用网页调试工具调试体验接口,请参考使用网页调试工具获取access_token

请求说明

基本信息

请求地址https://aip.baidubce.com/oauth/2.0/token

请求方式 :POST(推荐)

Header参数

名称 类型 必填 描述
Content-Type string 固定值application/json

Query参数

名称 类型 必填 描述
grant_type string 固定值client_credentials
client_id string 应用的API Key,说明:
(1)在千帆ModelBuilder控制台-应用列表查看
image.png
(2)如果应用列表无应用,需先创建应用,请参考如何创建应用
client_secret string 应用的Secret Key,说明:
(1)在千帆ModelBuilder控制台-应用列表查看
image.png
(2)如果应用列表无应用,需先创建应用,请参考如何创建应用

响应说明

名称 类型 描述
access_token string 访问凭证
expires_in int 有效期,Access Token的有效期。
说明:单位是秒,有效期30天
error string 错误码
说明:响应失败时返回该字段,成功时不返回
error_description string 错误描述信息,帮助理解和解决发生的错误
说明:响应失败时返回该字段,成功时不返回
session_key string 暂时未使用,可忽略
refresh_token string 暂时未使用,可忽略
scope string 暂时未使用,可忽略
session_secret string 暂时未使用,可忽略

请求示例

# 获取access_token,替换下列示例中的API Key与Secret Key
curl -X POST 'https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=[API Key]&client_secret=[Secret Key]'  -H 'Content-Type: application/json' 
import requests
import json


def main():
        
    url = "https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=xxxxxx&client_secret=xxxxx"
    
    payload = ""
    headers = {
        'Content-Type': 'application/json',
        'Accept': 'application/json'
    }
    
    response = requests.request("POST", url, headers=headers, data=payload)
    
    print(response.text)
    

if __name__ == '__main__':
    main()

响应示例

{
	"refresh_token":"25.a7c83604448xxxxx-33345604",
	"expires_in": 2592000,
	"session_key": "9mzdDtAOJUlG5lZxxxxxFwwO7hTmMQ==",
	"access_token": "24.5b04xxxxx000.169-33345604",
	"scope": "ai_custom_yiyan_com_eb_instant license_license ai_custom_retail_image_stitch easydl_pro_job xxxxx",
	"session_secret": "6a29xxxxx671cc"
}

错误码

如果请求错误,服务器返回的JSON文本包含以下参数。

名称 描述
error 错误码;关于错误码的详细信息请参考下方鉴权认证错误码
error_description 错误描述信息,帮助理解和解决发生的错误

例如,调用失败时返回:

{
    "error_description":"unknown client id",
    "error":"invalid_client"
 }
错误码 错误信息 描述
invalid_client unknown client id API Key不正确
invalid_client Client authentication failed Secret Key不正确
上一篇
鉴权介绍
下一篇
使用教程