您好,欢迎您使用 veImageX,以下内容适用于您已在其他产品存储了资源,现需使用 veImageX 的存储、图像处理、资源分发能力,请参考下文快速接入 veImageX 的产品功能。
准备工作
- 请您先完成火山引擎账号注册。
- 如果您首次登录火山引擎控制台,请先完成实名认证。
- 准备 1 个域名用于绑定服务域名,国内域名请提前完成备案。
- 建议准备 1 张图片,用于测试上传流程。
接入流程

背景信息
veImageX 支持多种形式接入,同时提供素材资源托管与图像处理两类服务,两种区别如下:
- 素材托管服务:支持任意合法资源的上传和托管;
- 图像处理服务:支持任意合法资源的上传和托管,还支持对图像文件执行图像实时处理。
前置准备
开通 veImageX 产品服务
- 登录火山引擎控制台。
- 单击页面左上角的产品与服务,选择 veImageX 产品,进入服务开通页面。veImageX 开通即送免费试用礼包。
- 选择合适的计费方式,开通页面提供按流量日结和按日峰值带宽日结两种计费方式,计费规则详情可参见计费概述。如需其他计费方式,请联系商务经理。

- 阅读并同意 veImageX 服务协议,勾选同意框后单击领取礼包并开通按钮。
- 单击去控制台,进入 veImageX 概览页面。

创建服务
注意
- 对于国内服务/域名,每日 9~21 点内新建的服务/域名将在 10 分钟内审核完成,21 点后到次日 9 点前创建的服务/域名将于次日 10 点前审核完成。
- 对于海外服务,审核完成时间约为 3 个工作日;对于海外域名,审核完成时间约为 24 小时。
- 在 veImageX 控制台,选择服务管理 > 新建服务。
- 在新建服务弹框中,根据提示信息,参考新建服务完成相关配置信息。

- 点击确定,完成服务的创建。
能力配置
配置 CNAME
为保证已添加的服务域名指向 veImageX 平台,您需要将域名解析到平台分配的 CNAME 地址。服务域名将在审核通过后才会显示 CNAME 值,请耐心等待;如有问题,请联系我们。
- 在域名列表中找到添加的域名,复制对应的 CNAME 地址。

- 使用域名服务对应的 DNS 解析平台,添加域名 CNAME 解析记录。
- 您可使用 ping 或 dig 的方式查验域名解析结果。如果域名 CNAME 地址与域名管理页面结果一致,则表示成功解析,可以正常使用该域名。
配置镜像回源
当需要通过镜像回源方式访问历史资源时,请参考以下步骤配置回源信息。
- 在服务管理页面,选择对应服务,单击基础配置进入服务配置页面。
- 找到镜像回源,单击修改按钮。您可参考配置镜像回源填写配置。

- 单击保存按钮,保存当前配置。
配置模板
- 选择图片处理配置 > 新建模板。
- 在新建模板页面,按照具体业务需求完成功能选择和参数配置。您可在图片处理配置查看各基础能力说明。

- 点击保存,完成图片模板配置。
上传文件(可选)
说明
已配置镜像回源后,veImageX 会向回源规则指定的源站获取这个文件。在获取到目标文件后,veImageX 会将文件返回给请求方并存入 Bucket。
- 选择资源管理 > 上传文件。
- 在文件上传页面,根据提示完成文件上传。

使用验证
获取地址
说明
请确保已在控制台上传了存储资源,推荐在前期调试时使用。
选择资源管理 > 上传文件。
在文件的操作列,单击获取地址。
选择域名和图像模板,单击生成地址,得到处理图 URL/源文件 URL。

您可通过手动拼接处理资源 URL (URL 可以保持同历史一致)方式获取访问地址。
更多功能
veImageX 控制台还提供了证书管理、数据统计监控以及 SDK 配置下发等功能,具体操作详情请见控制台指南。
veImageX 还提供了丰富的 SDK 与 OpenAPI 来帮助开发者快速完成接入。