零基础调用文心大模型4.5API实操手册

一、前期准备（5分钟完成）

1. 开通千帆服务

1. 登录百度智能云
2. 进入「千帆大模型平台」→「立即开通」

2. 创建应用

1. 控制台左侧导航栏选择「应用接入」
2. 点击「创建应用」→ 填写应用名称（如”MyFirstAIApp”）
3. 创建成功后，左侧选择应用列表，里面可以看到刚刚创建的应用，里面包含了AppID、API Key、Secret Key（需点击显示），这些请务必不要泄露。

3.服务授权

应用创建后，选择对应授权的公有云服务。

4.获取access_token

 
 

  
  
import requests
  
  
import time
  
  
class TokenManager:
  
  
 def __init__(self, api_key, secret_key):
  
  
 self.api_key = api_key
  
  
 self.secret_key = secret_key
  
  
 self.token = None
  
  
 self.expire_time = 0
  
  

  
  
 def get_token(self):
  
  
 if time.time() < self.expire_time - 300: # 提前5分钟刷新
  
  
 return self.token
  
  

  
  
 url = f"https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id={self.api_key}&client_secret={self.secret_key}"
  
  
 response = requests.get(url)
  
  
 if response.status_code == 200:
  
  
 data = response.json()
  
  
 self.token = data['access_token']
  
  
 self.expire_time = time.time() + data['expires_in']
  
  
 return self.token
  
  
 else:
  
  
 raise Exception(f"获取token失败: {response.text}")
  
  
# 使用示例
  
  
token_mgr = TokenManager("您的API Key", "您的Secret Key")
  
  
access_token = token_mgr.get_token()
 
 

5.调用对话API（ERNIE-Bot-4.5）

使用AppID、Access Token和模型接口URL调用文心一言，详见API列表。

6.在线调试

\百度智能云千帆提供了** API在线调试平台-示例代码 \，用于帮助开发者调试接口**，平台集成快速检索、查看开发文档、查看在线调用的请求内容和返回结果、复制和下载示例代码等功能，简单易用，更多内容请查看API在线调试介绍。

二、本地环境配置（Python版）

1. 安装必备工具

 
 

  
  
# Windows用户推荐使用Anaconda
  
  
conda create -n wenxin python=3.9
  
  
conda activate wenxin
  
  

  
  
# 安装官方SDK（含4.5支持）
  
  
pip install qianfan
 
 

2. 配置密钥（两种方式任选）

\方法一：环境变量配置（推荐）**

 
 

  
  
# Windows系统
  
  
setx QIANFAN_AK "your-api-key"
  
  
setx QIANFAN_SK "your-secret-key"
  
  

  
  
# Mac/Linux
  
  
export QIANFAN_AK="your-api-key"
  
  
export QIANFAN_SK="your-secret-key"
 
 

\方法二：代码内显式声明**

 
 

  
  
import qianfan
  
  
qianfan.AK("your-api-key")
  
  
qianfan.SK("your-secret-key")
 
 

三、新手代码模板（带逐行解读）

 
 

  
  
# 导入库
  
  
from qianfan.resources import ChatCompletion
  
  

  
  
def simple_chat(question):
  
  
 # 初始化对话客户端
  
  
 chat = ChatCompletion(model="ERNIE-Bot-4.5")
  
  

  
  
 # 构建对话结构
  
  
 messages = [{
  
  
 "role": "user",
  
  
 "content": question
  
  
 }]
  
  

  
  
 # 发起API请求
  
  
 resp = chat.do(
  
  
 messages=messages,
  
  
 temperature=0.8, # 控制创造性（0-1，越大结果越多样）
  
  
 top_p=0.9, # 采样范围（0-1，越小结果越确定）
  
  
 max_output_tokens=500 # 限制响应长度
  
  
 )
  
  

  
  
 # 处理响应结果
  
  
 if resp.code == 200:
  
  
 print("【AI回答】", resp.body["result"])
  
  
 print("本次消耗token数：", resp.body["usage"])
  
  
 else:
  
  
 print("请求失败，错误码：", resp.code)
  
  

  
  
# 测试对话
  
  
if __name__ == "__main__":
  
  
 user_input = input("请输入您的问题：")
  
  
 simple_chat(user_input)
 
 

四、新手避坑指南

1. 常见错误处理

错误现象	解决方案
ModuleNotFoundError: No module named 'qianfan'	执行 pip install qianfan --upgrade
Error code: 110	检查AK/SK是否正确且未过期
响应内容不全	增大 max_output_tokens 参数值
长时间无响应	添加 request_timeout=30 参数限制超时

2. 参数调节技巧

• \回答太简短** → 设置 max_output_tokens=1000
• \回答不聚焦** → 调整 temperature=0.3（降低随机性）
• \需要专业回答** → 添加 system 角色提示词：

 
 

  
  
messages = [
  
  
 {"role": "system", "content": "你是一名资深IT架构师"},
  
  
 {"role": "user", "content": "如何设计高并发系统？"}
  
  
]
 
 

五、进阶学习路径

1. \流式输出**：添加 stream=True 参数实现逐字输出效果
2. \知识库接入**：在控制台创建企业知识库，调用时附加 knowledge_id 参数
3. \计费查看**：控制台→费用中心→大模型服务账单，监控调用消耗
4. \服务监控**：使用千帆平台自带的「调用统计」功能分析API使用情况

通过以上步骤，即使没有AI开发经验的用户，也可以在30分钟内完成首次API调用。建议从简单问答开始（如天气咨询、百科查询），逐步尝试复杂场景（多轮对话、表格生成等）。