安装及初始化--veImageX-火山引擎

文档中心

veImageX

请输入

Java SDK

安装及初始化

veImageX 支持使用 SDK 完成 API 的调用，您可参考以下内容快速完成服务端 Java SDK 的安装及初始化操作。

前提条件

已开通 veImageX 服务。
已安装 JDK 1.8 及以上版本，可通过 java -version 命令查看当前版本。
已获取访问 veImageX 所需的 AK/SK。由于主账号 AK/SK 一旦泄漏，将有严重的安全风险，推荐您使用临时访问凭证来访问产品服务。

注意事项

为避免 AK/SK 泄漏，引起安全风险。建议您定期更换 AK 和 SK、使用访问策略限制权限、采用安全存储等方式提高安全性。

安装 SDK

在您的 maven 工程目录下的 pom.xml 文件中添加依赖，示例如下所示。

<dependency>
    <groupId>com.volcengine</groupId>
    <artifactId>volc-sdk-java</artifactId>
    <version>最新版本</version>
</dependency>

注意

推荐您使用最新版本的 SDK。

初始化

配置访问 AK/SK

veImageX 支持两种 AK 和 SK 的配置方式，在验证和测试阶段，您可以使用在调试 Demo 中配置的方式。如果需要发布到生产环境，请使用在环境变量中配置的方式。

注意

在调用中，系统会自动读取配置参数，您在调试代码中配置的 AK 和 SK 优先级高于环境变量配置。

在环境变量中配置

在调试 Demo 中配置

在 Linux 或 macOS 系统中配置
请在命令行终端执行以下命令，并传入已准备好的 AK 和 SK。

export VOLC_ACCESSKEY="ak"
export VOLC_SECRETKEY="sk"

在 Windows 系统中配置
新建系统环境变量，添加环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，并传入已准备好的 AK 和 SK。

警告

该方式有潜在的安全风险，因此在生产环境中，请勿使用该方式配置明文 AK/SK。

每次调用 veImageX 相关功能时传入 AK 和 SK 参数，适用于快速验证和测试。

ImagexService service = ImagexService.getInstance();
        service.setAccessKey("ak");
        service.setSecretKey("sk");
})

配置访问 Region

veImageX 支持以下两个地域：

cn-north-1：（默认）国内
ap-southeast-1：亚太东南（柔佛）

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

ImagexService service = ImagexService.getInstance(); // 默认地域为国内
ImagexService service = ImagexService.getInstance("ap-southeast-1") // 指定地域为亚太东南（柔佛）

后续步骤

至此，您已成功完成 java SDK 的安装和初始化。接下来，您可以参考各接口的调试示例来使用相应的能力。

最近更新时间：2025.12.17 14:05:28

这个页面对您有帮助吗？

有用

无用

veImageX

前提条件 #

注意事项 #

安装 SDK #

初始化 #

配置访问 AK/SK #

配置访问 Region #