本文档旨在指导 Go 开发者如何快速地将视频点播服务端 SDK 集成到您的项目中，并完成客户端的初始化。

集成步骤 #

步骤 1：安装 SDK #

视频点播 Go SDK 通过 Go Modules 进行管理。请在您的终端中执行以下命令来获取 SDK。

go get github.com/volcengine/volc-sdk-golang

步骤 2：配置访问凭证（AK/SK） #

为了让 SDK 能够验证您的身份并发起 API 调用，您需要配置访问密钥（Access Key）。

方式 1：通过环境变量配置（推荐）

此方式将敏感信息与代码解耦，提升了安全性。您只需在运行程序的服务器环境中设置以下两个环境变量即可，SDK 会自动读取。

export VOLC_ACCESSKEY="Your_AK"
export VOLC_SECRETKEY="Your_SK"

方式 2：通过配置文件配置

您可以在用户主目录（~）下创建一个 .volc/config 文件，并按以下 JSON 格式填入您的 AK 和 SK。SDK 会自动从此路径加载凭证。

{
   "ak":"Your_AK",
   "sk":"Your_SK"
}

方式 3：在代码中显式设置

在某些临时测试或特殊场景下，您也可以在代码中直接设置 AK 和 SK。

import (
    "github.com/volcengine/volc-sdk-golang/base"
    "github.com/volcengine/volc-sdk-golang/service/vod"
)

instance := vod.NewInstance()
instance.SetCredential(base.Credentials{
    AccessKeyID:     "Your_AK",
    SecretAccessKey: "Your_SK",
})

步骤 3：创建客户端 #

完成 SDK 安装和凭证配置后，您就可以初始化视频点播服务的客户端实例 *vod.Vod 了。

场景 1：创建默认地域的实例

最简单的方式是创建一个使用默认地域（华北1 cn-north-1）的实例。

import "github.com/volcengine/volc-sdk-golang/service/vod"

// 如果您已通过环境变量或配置文件设置 AK/SK，则无需再调用 SetCredential
instance := vod.NewInstance()

场景 2：创建指定地域的实例

如果您的业务需要访问特定地域（Region）的服务，可以在初始化时传入地域参数。

import (
    "github.com/volcengine/volc-sdk-golang/base"
    "github.com/volcengine/volc-sdk-golang/service/vod"
)

// 创建一个华北1 (cn-north-1) 地域的实例
instanceNorth1 := vod.NewInstanceWithRegion(base.RegionCnNorth1)

// 创建一个亚太东南1 (ap-southeast-1) 地域的实例
// 注意：亚太东南（柔佛）请使用 v1.0.141 或之后版本
instanceApSouthEast1 := vod.NewInstanceWithRegion(base.RegionApSouthEast1)

步骤 4：发起 API 调用 #

获取到实例后，您就可以调用具体的方法来发起 API 请求了。不同功能模块的接口调用示例，请参见以下文档：

• 空间管理
• 媒资上传
• 媒资管理
• 视频剪辑
• 媒体处理
• 音视频播放
• 点播 CDN
• 数据统计
• 工具服务
• 其他配置