Go SDK调用平台功能API教程
更新时间：2025-04-23
本章节介绍了如何通过Go语言 SDK调用千帆平台的API能力。通过本章节，你将了解安装Go SDK，并通过SDK调用获取预置服务列表API能力。
前期准备
在开始本教程操作步骤之前，需要完成以下准备工作：
- 确保已安装了Go，支持 Golang >= 1.18 版本。
- 确保已完成注册百度智能云账号。注意：为保障服务稳定运行，账户最好不处于欠费状态。
实现效果
例如，用户想要了解千帆大模型平台有哪些预置服务？
调用获取预置服务列表接口，可查看当前千帆大模型平台提供的预置服务。
步骤一：安装SDK
使用以下命令安装Go语言 SDK。
go get github.com/baidubce/bce-qianfan-sdk/go/qianfan步骤二：查看示例代码
本文以调用获取预置服务列表为例。
（1）点击查看获取预置服务列表，并点击复制示例代码。
注意：本文示例使用安全认证Access Key、Secret Key进行初始化认证信息。
调用示例代码如下：
- Call()方法需传递的参数：
请求地址的后缀、Query参数的Action、Body参数请参考预置服务列表API
package main
import (
"context"
"fmt"
"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")
ca := qianfan.NewConsoleAction()
res, err := ca.Call(context.TODO(),
// 调用本文API，该参数值为固定值，无需修改；对应API调用文档-请求结构-请求地址的后缀
"/v2/service",
// 调用本文API，该参数值为固定值，无需修改；对应API调用文档-请求参数-Query参数的Action
"DescribePresetServices",
// 请查看本文请求参数说明，根据实际使用选择参数；对应API调用文档-请求参数-Body参数
map[string]any{
"serviceIds": []string{"svcp-7940ab471306"},
})
if err != nil {
panic(err)
}
fmt.Println(string(res.Body))
}（2）复制代码到本地
将代码复制到本地环境，如下图所示。
步骤三：修改示例代码
（1）修改相关参数值
需修改Access Key、Secret Key、route、action、data值，如下所示：
| 参数名称 | 修改前的值 | 修改后的值 |
|---|---|---|
| QIANFAN_ACCESS_KEY | your_iam_ak | · 示例：ALTAKRG****HTRtGVgO · 如何获取该参数值： 在百度智能云控制台-用户账户-安全认证页，查看Access Key、Secret Key。  |
| QIANFAN_SECRET_KEY | your_iam_sk | · 示例：c05e36c**da79f8 · 如何获取该参数值： 在百度智能云控制台-用户账户-安全认证页，查看Access Key、Secret Key。 |
| route | /v2/service | 请求地址的后缀，本文示例无需修改此参数值 |
| action | DescribePresetServices | Query参数的Action，本文示例无需修改此参数值 |
| data | "serviceIds": []string{"svcp-7940ab471306"} | Body参数，修改参数值为："serviceIds": []string{"svcp-dfd7468a1315"},"serviceType": []string{"text2image"}, |
（2）修改相关参数后，如下图所示。
步骤四：运行代码
运行代码，调用成功后返回示例如下。
