获取access_token

更新时间：2024-11-11

功能介绍

调用本文接口获取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（推荐）

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

Query参数

名称	类型	必填	描述
grant_type	string	是	固定值client_credentials
client_id	string	是	应用的API Key，说明：（1）在千帆ModelBuilder控制台-应用列表查看（2）如果应用列表无应用，需先创建应用，请参考如何创建应用
client_secret	string	是	应用的Secret Key，说明：（1）在千帆ModelBuilder控制台-应用列表查看（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不正确

鉴权介绍

使用教程

百度智能云

百度智能云千帆大模型服务与开发平台ModelBuilder