初始化

Golang SDK 可通过 Access Key 初始化。您可以根据需求选择设置 AK/SK 的方法。本文为您介绍初始化的操作步骤。

前提条件

• 已注册火山引擎账号，完成实名认证，并开通了 veImageX 图片服务。
• 准备好访问 veImageX 服务使用的 Access Key。可以在密钥管理创建主账号 Access Key，也可以在用户管理中创建子账号，并授予 veImageX 权限后进行相应操作。

初始化

AK/SK 配置

支持 3 种 AK/SK 的设置方法。

• 方法一：在业务代码中配置（推荐）

显式调用 ImageX 的 SetCredential 方法，代码示例如下所示：

instance := imagex.DefaultInstance
instance.SetCredential(base.Credentials{
	AccessKeyID:      "your ak",
	SecretAccessKey: "your sk",
})

• 方法二：在环境变量中配置

VOLC_ACCESSKEY="ak"
VOLC_SECRETKEY="sk"

• 方法三：在系统文件中配置
  在本地的~/.volc/config中添加的文件结构如下所示。

{
    "ak":"your ak",
    "sk":"your sk"
}

以上三种配置方式优先级依次降低，若采用多种方式，以优先级最高的配置信息为准。

地域 Region 设置

目前支持以下三个地域：

• cn-north-1 (默认)：国内
• ap-singapore-1：新加坡
• us-east-1：美东

默认地域为中国（cn-north-1），若需调用其它地域服务，请在初始化时传入指定的地域信息。

instance := imagex.DefaultInstance // 默认地域为中国
instance = imagex.NewInstanceWithRegion("us-east-1") // 指定地域为美东