Python SDK使用教程
更新时间:2024-07-10
本章节介绍了如何通过Python语言 SDK调用千帆平台的API能力。通过本章节,你将了解如何创建应用、安装SDK、查看SDK文档,并通过SDK调用ERNIE 3.5模型API能力。
实现效果
例如,希望了解百度智能云千帆大模型平台产品,选择使用ERNIE-3.5-8K模型版本API进行对话。即
- 用户发起提问:介绍下千帆大模型平台
- 调用ERNIE-3.5-8K模型API后,接口返回千帆大模型平台相关的介绍,如“千帆大模型平台是一站式企业级大模型平台”等。
前期准备
在开始本教程操作步骤之前,需要完成以下准备工作:
- 确保已安装了Python,千帆SDK 支持 Python >= 3.7版本。
- 确保已完成注册百度智能云账号。注意:为保障服务稳定运行,账户最好不处于欠费状态。
- 确保已开通API调用权限。注意:针对付费服务,如果用户在使用过程中,操作了终止付费,则无法调用对应的API。如需重新开通,请在千帆大模型平台-在线服务页面,点击开通付费。
步骤简介
步骤一:安装SDK。
步骤二:查看文档。
步骤三:修改示例代码参数。
步骤四:运行代码。
步骤一:安装SDK
使用以下命令安装SDK
pip install qianfan
步骤二:查看文档
找到需调用的API文档,查看示例代码。
例如,本文示例希望调用ERNIE-3.5-8K。在API列表,查找调用该模型所对应的ERNIE-3.5-8K文档,并点击跳转。
(1)打开文档,找到调用示例
在ERNIE-3.5-8K文档页面,找到示例代码,并点击复制代码。
代码如下
import os
import qianfan
#【推荐】使用安全认证AK/SK鉴权,通过环境变量初始化认证信息
# 替换下列示例中参数,安全认证Access Key替换your_iam_ak,Secret Key替换your_iam_sk
os.environ["QIANFAN_ACCESS_KEY"] = "your_iam_ak"
os.environ["QIANFAN_SECRET_KEY"] = "your_iam_sk"
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、Secret Key。 ![]() |
QIANFAN_SECRET_KEY | your_iam_sk | · 示例:c05e36c**da79f8 · 如何获取该参数值: 在百度智能云控制台-用户账户-安全认证页,查看Access Key、Secret Key。 ![]() |
model | ERNIE-3.5-8K | 设置使用的模型,本文示例无需修改此参数值 |
content | 介绍下你自己 | 设置聊天上下文信息中的content内容,内容修改为“介绍下千帆大模型平台” |
(2)修改相关参数后,如下图所示。
步骤四:运行代码
运行代码,调用成功后返回示例如下。