Python SDK使用教程

更新时间：2024-11-12

本章节介绍了如何通过Python语言 SDK调用千帆ModelBuilder的API能力。通过本章节，你将了解如何安装SDK、查看示例代码，并通过SDK调用ERNIE 3.5模型API能力。

实现效果

例如，希望发起对话，选择使用ERNIE-3.5-8K模型版本API进行对话。即

用户发起提问：你好
调用ERNIE-3.5-8K模型API后，接口返回相关对话内容，如“'你好！请问有什么我可以帮助你的吗？”等。

前期准备

在开始本教程操作步骤之前，需要完成以下准备工作：

确保已安装了Python，千帆ModelBuilder SDK 支持 Python >= 3.7版本。
确保已完成注册百度智能云账号。注意：为保障服务稳定运行，账户最好不处于欠费状态。
确保已开通API调用权限。平台已默认开通API调用权限，无需申请授权。

步骤一：安装SDK

使用以下命令安装SDK

bash

pip install qianfan

步骤二：查看示例代码

例如，本文示例希望调用ERNIE-3.5-8K。

（1）点击查看ERNIE-3.5-8K文档，并点击复制示例代码。

注意：本文示例使用安全认证Access Key、Secret Key进行初始化认证信息。如果使用应用API_Key、应用Secret key初始化，请注意替换环境变量相关参数，参考以下示例代码。

Python

import os
import qianfan

# 通过环境变量初始化认证信息
# 方式一：【推荐】使用安全认证AK/SK
# 替换下列示例中参数，安全认证Access Key替换your_iam_ak，Secret Key替换your_iam_sk，如何获取请查看https://cloud.baidu.com/doc/Reference/s/9jwvz2egb
os.environ["QIANFAN_ACCESS_KEY"] = "your_iam_ak"
os.environ["QIANFAN_SECRET_KEY"] = "your_iam_sk"

# 方式二：【不推荐】使用应用AK/SK鉴权
# 替换下列示例中参数，将应用API_Key、应用Secret key值替换为真实值
#os.environ["QIANFAN_AK"] = "应用API_Key"
#os.environ["QIANFAN_SK"] = "应用Secret_Key"

chat_comp = qianfan.ChatCompletion()

# 指定特定模型
resp = chat_comp.do(model="ERNIE-3.5-8K", messages=[{
    "role": "user",
    "content": "你好"
}])

print(resp["body"])

（2）复制代码到本地

将代码复制到本地环境，如下图所示。

步骤三：修改示例代码

（1）修改相关参数值

需要修改Access Key、Secret Key、model、content等值，如下所示：

参数名称	修改前的值	修改后的值
QIANFAN_ACCESS_KEY	your_iam_ak	· 示例：ALTAKRG**HTRtGVgO · 如何获取该参数值：**在百度智能云控制台-用户账户-安全认证页，查看Access Key。
QIANFAN_SECRET_KEY	your_iam_sk	· 示例：c05e36cda79f8 · 如何获取该参数值：**在百度智能云控制台-用户账户-安全认证页，查看Secret Key。
model	ERNIE-3.5-8K	设置使用的模型，本文示例无需修改此参数值
content	你好	设置聊天上下文信息中的content内容，本文示例无需修改此参数值；也可以修改为其他希望提问的内容，如修改为“介绍下北京”等