Go SDK调用平台功能API教程

更新时间：2025-04-23

本章节介绍了如何通过Go语言 SDK调用千帆平台的API能力。通过本章节，你将了解安装Go SDK，并通过SDK调用获取预置服务列表API能力。

前期准备

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

确保已安装了Go，支持 Golang >= 1.18 版本。
确保已完成注册百度智能云账号。注意：为保障服务稳定运行，账户最好不处于欠费状态。

实现效果

例如，用户想要了解千帆大模型平台有哪些预置服务？

调用获取预置服务列表接口，可查看当前千帆大模型平台提供的预置服务。

步骤一：安装SDK

使用以下命令安装Go语言 SDK。

Bash

1go get github.com/baidubce/bce-qianfan-sdk/go/qianfan

步骤二：查看示例代码

本文以调用获取预置服务列表为例。

（1）点击查看获取预置服务列表，并点击复制示例代码。

注意：本文示例使用安全认证Access Key、Secret Key进行初始化认证信息。

调用示例代码如下：

Call()方法需传递的参数：请求地址的后缀、Query参数的Action、Body参数请参考预置服务列表API

1package main
2
3import (
4    "context"
5    "fmt"
6    "os"
7
8    "github.com/baidubce/bce-qianfan-sdk/go/qianfan"
9)
10
11func main() {
12     // 使用安全认证AK/SK鉴权，通过环境变量初始化；替换下列示例中参数，安全认证Access Key替换your_iam_ak，Secret Key替换your_iam_sk
13    os.Setenv("QIANFAN_ACCESS_KEY", "your_iam_ak")
14    os.Setenv("QIANFAN_SECRET_KEY", "your_iam_sk")
15    
16    ca := qianfan.NewConsoleAction()
17    
18     res, err := ca.Call(context.TODO(),
19        // 调用本文API，该参数值为固定值，无需修改；对应API调用文档-请求结构-请求地址的后缀
20        "/v2/service",
21        // 调用本文API，该参数值为固定值，无需修改；对应API调用文档-请求参数-Query参数的Action 
22        "DescribePresetServices",
23        // 请查看本文请求参数说明，根据实际使用选择参数；对应API调用文档-请求参数-Body参数
24        map[string]any{
25            "serviceIds": []string{"svcp-7940ab471306"},
26        })
27    if err != nil {
28        panic(err)
29    }
30    fmt.Println(string(res.Body))
31    
32}

（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	· 示例：c05e36cda79f8 · 如何获取该参数值：** 在百度智能云控制台-用户账户-安全认证页，查看Access Key、Secret Key。
route	/v2/service	请求地址的后缀，本文示例无需修改此参数值
action	DescribePresetServices	Query参数的Action，本文示例无需修改此参数值
data	"serviceIds": []string{"svcp-7940ab471306"}	Body参数，修改参数值为："serviceIds": []string{"svcp-dfd7468a1315"},"serviceType": []string{"text2image"},