文心大模型4.5 API调用实操指南（附完整Python代码）

一、开发前准备（避坑指南）

1. 环境清单：Python 3.8.16 + VENV虚拟环境 + Postman调试工具

工具	版本要求	作用说明
Python	≥3.7 (推荐3.8+)	API请求库依赖
PyCharm	2022.3+	代码调试可视化
conda	4.12.0+	隔离SDK依赖环境
requests库	2.28.0+	API通信基础组件

. 账号配置五步走

1. 注册百度智能云账号
2. 进入「千帆大模型平台」
3. 左侧导航栏选择 应用接入 > 创建应用，即创建自己的API，创建成功后，左侧选择应用列表，里面可以看到刚刚创建的应用，里面包含了AppID、API Key、Secret Key（需点击显示），这些请务必不要泄露。

1. 重点提醒：开启所有可选项服务（实际计费按调用量结算）

三、代码实战：5分钟完成API调用

1. SDK配置（二选一方案）

# 方案一：命令行安装
pip install qianfan --upgrade  # 推荐官方SDK

# 方案二：PyCharm可视化安装

2. 完整示例代码（文心4.5版本）

import qianfan

# 从环境变量读取密钥（安全做法）
chat_comp = qianfan.ChatCompletion(ak="YOUR_API_KEY", sk="YOUR_SECRET_KEY")

# 调用ERNIE-4.0模型
resp = chat_comp.do(
    model="ERNIE-Bot-4.5",
    messages=[{
        "role": "user",
        "content": "用鲁迅的文风写三行代码注释"
    }]
)

print("文心4.5生成结果：\n", resp["result"])

3. 参数详解表

参数名	示例值	作用说明
model	ERNIE-Bot-4.5	指定大模型版本
temperature	0.8	生成结果随机性(0-1)
top_p	0.9	核采样阀值

四、常见报错解决方案

1. 鉴权失败（error_code: 17）

# 正确获取access_token的姿势
def get_access_token():
    url = "https://aip.baidubce.com/oauth/2.0/token"
    params = {
        "grant_type": "client_credentials",
        "client_id": API_KEY,  # 从控制台获取
        "client_secret": SECRET_KEY
    }
    return requests.post(url, params=params).json().get("access_token")

2. 服务未开通（error_code: 6）

1. 登录千帆平台进入计费管理
2. 勾选需要启用的服务：
   ✅ 语言大模型ERNIE-Bot
   ✅ 模型精调服务

五、高级技巧：批量信息处理

# 批量问答模板（适合信息抽取）
def batch_process(questions: list):
    results = []
    for q in questions:
        resp = chat_comp.do(
            model="ERNIE-Bot-4.5",
            messages=[{"role": "user", "content": q}],
            temperature=0.2  # 降低随机性
        )
        results.append(resp["result"])
    return results

# 调用示例
questions = ["解析合同中的甲方名称", "抽取摘要关键日期"]
print(batch_process(questions))

六、成本优化方案

计费模式对比

套餐类型	适合场景	单价（元/千tokens）
按量付费	初期测试	0.012
资源包	稳定用量	0.008（买10万赠2万）
企业定制	日调用量>500万	可议价

实战建议：使用token计算工具预估用量

from qianfan.utils import token_count
text = "需要计算的内容"
print(f"消耗token数: {token_count(text)}")

七、更多学习资料

1. 千帆官方文档中心
2. 开发者中心：https://developer.baidu.com/
3. 开发者交流论坛：百度AI社区