Go 版本不低于 1.18。

• 源码地址：https://github.com/volcengine/volcengine-go-sdk

火山方舟 Go SDK 使用 go mod 进行管理，如果本地工程没有初始化 go mod，您可以运行以下命令初始化 go mod。

go mod init example

在本地初始化 go mod 后，运行以下命令安装最新版 SDK。

go get -u github.com/volcengine/volcengine-go-sdk

在代码中引入 SDK 使用。

import "github.com/volcengine/volcengine-go-sdk/service/arkruntime"

更新依赖后，使用以下命令清理不需要的依赖并整理 go.mod和 go.sum文件。

go mod tidy

详细请参见1.获取并配置 API Key 。

import (
    "os"
    "github.com/volcengine/volcengine-go-sdk/service/arkruntime"
)

client := arkruntime.NewClientWithApiKey(
    os.Getenv("ARK_API_KEY"),
)

设置地域和访问域名

代码示例中 <ARK_BASE_URL> 处填写火山方舟推理接入点/应用资源所在区域对应的访问域名，如不填默认访问华北 2 (北京)。火山方舟支持的地域和访问域名参见地域和访问域名。

import (
    "os"
    "github.com/volcengine/volcengine-go-sdk/service/arkruntime"
)
// 以华北 2 (北京) 为例，<ARK_BASE_URL> 处应改为 https://ark.cn-beijing.volces.com/api/v3
client := arkruntime.NewClientWithApiKey(
    os.Getenv("ARK_API_KEY"),
    arkruntime.WithBaseUrl("<ARK_BASE_URL>"),
)

设置超时/重试次数

import (
    "os"
    "time"
    "github.com/volcengine/volcengine-go-sdk/service/arkruntime"
)

client := arkruntime.NewClientWithApiKey(
    os.Getenv("ARK_API_KEY"),
    arkruntime.WithTimeout(2*time.Minute),
    arkruntime.WithRetryTimes(2),
)

使用Access Key鉴权

1. 获取到Access Key。如需创建/查看Access Key，请参见API访问密钥管理。
2. 设置API密钥到环境变量，推荐命名为：VOLC_ACCESSKEY和VOLC_SECRETKEY。

环境变量配置方法类似API Key配置环境变量，具体请参见 配置 API Key 到环境变量。

3. 按照下面示例代码进行初始化。

import (
    "os"
    "time"
    "github.com/volcengine/volcengine-go-sdk/service/arkruntime"
)

client := arkruntime.NewClientWithAkSk(
        os.Getenv("VOLC_ACCESSKEY"),
        os.Getenv("VOLC_SECRETKEY"),
)