Go SDK使用教程
更新时间：2024-11-11
本章节介绍了如何通过Go语言 SDK调用千帆ModelBuilder的API能力。通过本章节，你将了解安装Go SDK，并通过SDK调用ERNIE 3.5模型API能力。
实现效果
例如，希望了解北京，选择使用ERNIE-3.5-8K模型API进行对话。即
用户发起提问：介绍下北京
调用ERNIE-3.5-8K模型API后，接口返回北京相关的介绍，如“北京，中华人民共和国的首都，是一座拥有悠久历史和灿烂文化的古都”等。
前期准备
在开始本教程操作步骤之前，需要完成以下准备工作：
- 确保已安装了Go，支持 Golang >= 1.18 版本。
- 确保已完成注册百度智能云账号。注意：为保障服务稳定运行，账户最好不处于欠费状态。
- 平台已默认开通API调用权限，无需申请授权。
步骤一：安装SDK
使用以下命令安装Go语言 SDK。
go get github.com/baidubce/bce-qianfan-sdk/go/qianfan步骤二：查看示例代码
例如，本文希望调用ERNIE-3.5-8K模型API能力。点击查看ERNIE-3.5-8K文档，并点击复制，将示例代码复制到本地，代码如下。
package main
import (
"fmt"
"context"
"os"
"github.com/baidubce/bce-qianfan-sdk/go/qianfan"
)
func main() {
// 使用安全认证AK/SK鉴权，替换下列示例中参数，安全认证Access Key替换your_iam_ak，Secret Key替换your_iam_sk
os.Setenv("QIANFAN_ACCESS_KEY", "your_iam_ak")
os.Setenv("QIANFAN_SECRET_KEY", "your_iam_sk")
// 指定特定模型
chat := qianfan.NewChatCompletion(
qianfan.WithModel("ERNIE-3.5-8K"),
)
resp, err := chat.Do(
context.TODO(),
&qianfan.ChatCompletionRequest{
Messages: []qianfan.ChatCompletionMessage{
qianfan.ChatCompletionUserMessage("你好"),
},
},
)
fmt.Println(resp.Result)
}步骤三：修改示例代码
需修改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内容，内容修改为“介绍下北京” |
修改相关参数后，如下图所示。
步骤四：运行代码
运行代码，调用成功后返回示例如下。
北京，中华人民共和国的首都，是一座拥有悠久历史和灿烂文化的古都，也是中国的政治、文化、国际交往和科技创新中心。这座城市融合了古老与现代，传统与时尚，以其独特的魅力吸引着全世界的目光。
### 历史与文化
北京有着3000多年的建城史和860多年的建都史，是中国四大古都之一（西安、南京、洛阳、北京）。这里曾是元、明、清三朝的都城，留下了无数珍贵的历史遗迹，如故宫（紫禁城）、天坛、颐和园、圆明园遗址、长城（尤其是八达岭、慕田峪等段）等，这些不仅是中国的文化瑰宝，也是世界文化遗产。
### 现代都市风貌
随着时代的发展，北京已发展成为一个现代化的国际大都市。高楼大厦林立，如中央商务区（CBD）、中关村科技园区等地标性建筑和商圈，展现了北京的现代化面貌。同时，北京也是中国的科技创新中心，拥有众多高等学府和科研机构，如清华大学、北京大学、中国科学院等，为国家的科技进步和人才培养做出了巨大贡献。
### 美食与购物
北京的美食文化同样丰富多彩，既有传统的京味小吃如炸酱面、豆汁儿、焦圈、艾窝窝等，也有来自全国各地的风味佳肴和国际美食。购物方面，王府井步行街、三里屯太古里、SKP等商业区是购物和娱乐的好去处，汇聚了国内外众多知名品牌和时尚潮流。
### 旅游资源
除了历史遗迹和现代都市风貌外，北京还拥有丰富的旅游资源。春天可以赏花（如玉渊潭公园的樱花、颐和园的桃花），夏天可以避暑（如北海公园的荷花、香山公园的清凉），秋天则是赏红叶的最佳时节（如香山红叶），冬天则可以滑雪和体验冰上运动（如什刹海冰场）。此外，北京还有丰富的博物馆、艺术馆、剧院等文化设施，为游客提供了丰富的精神食粮。
### 国际交往
作为中国的首都和国际交往中心，北京经常举办各种国际会议、展览和体育赛事。例如，2008年北京成功举办了第29届夏季奥林匹克运动会和残奥会，向世界展示了中国的风采和实力。此外，北京还定期举办中国国际服务贸易交易会（服贸会）、北京国际电影节等重要活动，促进了国际间的交流与合作。
总之，北京是一座充满魅力和活力的城市，它既是中国的历史文化名城，也是现代化的国际大都市。无论你是来寻找历史的痕迹，还是体验现代的繁华；无论你是来品尝美食，还是享受购物的乐趣；无论你是来欣赏自然风光，还是感受人文底蕴——北京都能满足你的需求。