Go SDK使用说明
更新时间:2025-02-12
安装Go SDK
go get github.com/baidubce/bce-qianfan-sdk/go/qianfan
注意:目前支持 Golang >= 1.18 版本。
SDK 使用流程简介
千帆ModelBuilder提供了2种调用方式。API不同,调用方式可能不同。开发者可以根据实际使用,选择合适的方式进行调用。
调用方式 | 推理服务V2 | 推理服务V1 | 平台功能OpenAPI |
---|---|---|---|
使用API Key值调用 | ✓ | ✕ | ✕ |
使用安全认证AK/SK调用 | ✓ | ✓ | ✓ |
使用API Key值调用
步骤一,获取API Key
如何获取API Key值,请查看获取API Key值。
步骤二,初始化API Key
通过SDK调用API时,需通过环境变量初始化API Key值,SDK会根据提供的API Key值自动完成鉴权相关步骤。
// 通过环境变量初始化
import (
"os"
)
// 替换下列示例中参数,API Key值替换your_APIKeyyour_APIKey
os.Setenv("QIANFAN_BEARER_TOKEN", "your_APIKey")
步骤三,调用API
调用相关API,请参考对话Chat V2调用示例。
使用安全认证AK/SK鉴权调用流程
步骤一,获取安全认证AK/SK
通过以下步骤获取Access Key(AK)/Secret Key(SK),更多介绍请参考如何获取AK/SK。
(1)登录千帆ModelBuilder控制台
登录千帆ModelBuilder控制台 。注意:为保障服务稳定运行,账户最好不处于欠费状态。
(2)查看安全认证Access Key/Secret Key
在安全认证/Access Key 页面,查看Access Key、Secret Key。注意:
- 初始化鉴权时,使用“安全认证/Access Key”中的Access Key和 Secret Key进行鉴权,更多鉴权认证机制请参考鉴权认证机制。
- 安全认证Access Key(AK)/Secret Key(SK),和使用的获取AcessToken的应用API Key(AK) 和 Secret Key(SK)不同。
步骤二,初始化鉴权
支持通过环境变量、参数设置两种初始化方式。
- 方式一:通过环境变量初始化
// 通过环境变量初始化
import (
"os"
)
// 替换下列示例中参数,安全认证Access Key替换your_iam_ak,Secret Key替换your_iam_sk
os.Setenv("QIANFAN_ACCESS_KEY", "your_access_key")
os.Setenv("QIANFAN_SECRET_KEY", "your_secret_key")
- 方式二:通过参数初始化
import (
"github.com/baidubce/bce-qianfan-sdk/go/qianfan"
)
// 替换下列示例中参数,安全认证Access Key替换your_iam_ak,Secret Key替换your_iam_sk
qianfan.GetConfig().AccessKey = "your_access_key"
qianfan.GetConfig().SecretKey = "your_secret_key"
步骤三,调用SDK
调用对应的API,请参考各API文档调用示例。
使用教程
请查看Go SDK使用教程。