需先获取API Key与Secret Key并换取Access Token,再安装requests库,构造含Authorization头和messages等字段的POST请求,解析响应result字段获取结果。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您希望在Python项目中调用文心一言4.5的API服务,但尚未配置访问凭证或构造合法请求,则可能是由于认证参数缺失、请求体格式错误或SDK版本不兼容所致。以下是完成接入与调用的具体步骤:
一、获取API密钥与访问令牌
文心一言4.5 API采用Bearer Token鉴权机制,需通过百度云控制台申请API Key与Secret Key,并使用其换取短期有效的Access Token。该Token是每次HTTP请求必需的认证凭据,有效期为30天,需在代码中动态刷新。
1、登录百度智能云官网,进入“文心一言”产品页。
2、在“应用管理”中创建新应用,记录生成的API Key与Secret Key。
立即学习“Python免费学习笔记(深入)”;
3、向https://aip.baidubce.com/oauth/2.0/token发起POST请求,携带grant_type=client_credentials、client_id=[API Key]、client_secret=[Secret Key]三个参数。
4、从响应JSON中提取access_token字段值,保存为变量access_token供后续调用使用。
二、安装并导入必要依赖库
Python环境需具备HTTP客户端能力及JSON解析支持,推荐使用requests库发起标准REST请求;若需异步调用,可额外引入aiohttp。所有依赖均须通过pip安装,且版本需满足百度官方文档最低要求。
1、执行命令:pip install requests,确保requests库已安装至当前Python环境。
2、在Python脚本顶部添加:import requests和import json。
3、验证安装成功:运行python -c "import requests; print(requests.__version__)",输出版本号不低于2.28.0。
三、构造标准请求体并发送调用
文心一言4.5 API要求请求方法为POST,Content-Type为application/json,请求URL为https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/completions_pro(正式环境),请求体必须包含messages数组、model参数及stream开关等关键字段。
1、定义请求头字典:headers = {"Content-Type": "application/json", "Authorization": f"Bearer {access_token}"}。
2、构建请求体字典:payload = {"messages": [{"role": "user", "content": "你好"}], "model": "ernie-4.5-turbo", "stream": False}。
3、调用requests.post(url, headers=headers, json=payload),传入完整URL与上述参数。
4、检查响应状态码是否为200,若非200则打印response.text定位错误原因。
四、解析响应并提取生成文本
成功响应返回JSON格式数据,其中result字段为模型生成的纯文本内容;若启用stream模式,则需按SSE格式逐行读取chunk并拼接。本步骤仅处理非流式响应,适用于调试与简单场景。
1、调用response.json()将响应体转为Python字典。
2、使用data.get("result")安全提取生成结果,避免KeyError异常。
3、判断result是否为字符串类型,若是,则打印或返回该值;若为None,说明模型未返回有效内容,需检查error_code与error_msg字段。
4、示例输出应为:你好!我是文心一言,有什么可以帮您?。
五、处理常见错误响应码
API返回非200状态码时,表示请求未被服务端接受,需依据HTTP状态码分类排查。百度文心API对4xx与5xx错误有明确语义定义,错误信息直接嵌入响应体,无需额外查询文档即可定位根因。
1、响应码为401:确认access_token未过期且拼写正确,Authorization头格式必须为"Bearer {token}",注意Bearer后有一个空格。
2、响应码为400:检查messages数组是否为空、role是否仅含"user"或"assistant"、content是否为非空字符串。
3、响应码为404:核对请求URL中的模型路径是否为/wenxinworkshop/chat/completions_pro,不可误用/completions或/v1/chat/completions等旧路径。
4、响应码为429:同一API Key每秒调用超限,需在代码中加入time.sleep(0.1)进行节流,或申请更高配额。


















