文心一言4.5API接入教程_Python代码调用示例

Python调用文心一言4.5 API：从零到一的完整接入指南

想在你的Python应用里集成强大的文心一言4.5能力吗？整个过程其实比你想象的要清晰。下面这份指南，将一步步带你完成从获取密钥到成功调用的全过程。

如果你在调用时遇到了障碍，比如认证失败或者请求格式错误，问题通常出在几个关键环节：访问凭证未正确配置、请求体结构不符合规范，或是依赖库版本不匹配。别担心，跟着下面的步骤走，就能轻松解决。

一、获取API密钥与访问令牌

文心一言4.5的API采用标准的Bearer Token鉴权方式。这意味着，你需要先拿到一对“钥匙”——API Key和Secret Key，然后用它们去换一张有时效性的“通行证”，也就是Access Token。这张通行证有效期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 这个字段，把它存下来，后续调用就靠它了。

二、安装并导入必要依赖库

工欲善其事，必先利其器。在Python环境中，我们主要依赖 requests 库来处理HTTP请求。当然，如果你追求高性能的异步调用，aiohttp 也是个不错的选择。确保你的库版本符合官方要求，可以避免很多兼容性问题。

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，内容类型是application/json，并且URL地址要写对。请求体里，对话历史、模型选择和流式开关这几个字段至关重要。

1. 先定义请求头。它长这样：headers = {"Content-Type": "application/json", "Authorization": f"Bearer {access_token}"}。注意，Bearer后面那个空格千万不能少。

2. 接着，构建请求体。一个最简单的示例是这样的： payload = {"messages": [{"role": "user", "content": "你好"}], "model": "ernie-4.5-turbo", "stream": False}

3. 万事俱备，发送请求：requests.post(url, headers=headers, json=payload)。这里的url就是正式的接口地址：https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/completions_pro。

4. 发送后，先别急着看结果。检查一下响应状态码是不是200。如果不是，把 response.text 打印出来，里面通常包含了具体的错误原因。

四、解析响应并提取生成文本

如果上一步返回了状态码200，恭喜你，调用成功了！接下来就是“拆礼物”的环节——从响应数据里提取出AI生成的文本。我们这里以非流式响应为例，处理起来更直观。

1. 首先，用 response.json() 方法把返回的文本转换成Python字典，这样操作起来就方便了。

2. 然后，安全地从字典里取出生成的内容：data.get("result")。用 get 方法可以避免因字段缺失而报错。

3. 判断一下取出的 result 是不是字符串类型。如果是，就可以愉快地打印或使用它了。如果发现是None，别慌，去检查响应里是不是有 error_code 和 error_msg 字段，那里藏着错误详情。

4. 一切顺利的话，你将会看到类似这样的输出：你好！我是文心一言，有什么可以帮您？

五、处理常见错误响应码

开发过程中遇到错误响应再正常不过。关键在于如何快速定位问题。文心一言API的错误码设计得比较清晰，大部分问题都能从响应信息里直接找到线索。

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：这说明你的调用频率超限了。解决方案很简单，在代码里加入一点延迟，比如 time.sleep(0.1)，或者直接去申请更高的调用配额。

来源：互联网