veImageX
veImageX
- 文档首页
veImageX最佳实践平台使用最佳实践veImageX 内网数据互访
文档反馈
问问助手veImageX 面向企业用户提供灵活、高效的一站式图片处理解决方案。您可借助 veImageX 的上传、托管、智能处理和分发能力，批量处理图像、文档等各类素材。在一些业务场景下，需要通过内网访问 veImageX 内的资源，或者通过 veImageX 处理分发一些内网产生的资源，本文旨在为您介绍在内网读写访问的最佳实践。
本章节介绍内网数据互访的常见业务场景。
场景一：云上 VPC 服务通过内网读写 veImageX 资源
火山引擎私有网络（VPC，Virtual Private Cloud）为云上资源构建隔离的、自主配置和管理的虚拟网络环境。在一些数据训练、业务上云后，需要内网访问存入 veImageX 的资源，实现安全、高效的数据访问。
场景二：通过 veImageX 分发其他云服务产生的资源
使用火山引擎其他云服务生产的资源，veImageX 可以通过内网访问和上传，进行图片处理、图片分发。
例如：
- 在 火山引擎 ECS 云服务器 云服务器上生产的资源，比如 GPU 服务器上的 AIGC 大模型生产的资源，可通过内网上传到 veImageX 存储，通过 veImageX 的 CDN 进行分发。结合 veImageX 丰富的实时处理能力，可进一步对图片进行处理，比如：缩放、裁剪、图文水印、画质增强等。
- 资源已经存储在火山引擎对象存储 TOS，还希望使用 veImageX 的图片处理能力。可以将 ECS 云服务器作为中转站，内网读取 TOS 资源，再通过内网上传到 veImageX 存储。
- 注册火山引擎账号，并开通 veImageX 产品服务
- 新建服务，完成服务基础配置和域名配置
场景一：云上 VPC 服务通过内网读写 veImageX 资源
步骤一：将资源上传到 veImageX（可选）
通过公网上传方式，将资源上传到 veImageX。你可以通过服务端或客户端上传资源，详情参看 veImageX 上传最佳实践。
步骤二：通过 VPC 读取 veImageX 内的资源
说明
veImageX 在华北 2 地域提供服务，根据您的 VPC 区域不同，访问方式不同：
参考内网访问配置 veImageX 内网访问功能。配置完成后，即可使用内网域名访问源图片资源。
步骤三：将 VPC 内产生的资源上传回 veImageX
veImageX 提供 ApplyVpcUploadInfo 接口指定内网上传文件信息，并获取文件上传链接和 Header 信息。成功获取到上述信息后，按照链接及 Header 进行请求即可完成内网上传。
veImageX 提供了配套的服务端 SDK，支持多种编程语言，帮助您更方便的调用 API。
场景二：通过 veImageX 分发其他云服务产生的资源
步骤一：通过内网将资源上传到 veImageX
veImageX 提供 ApplyVpcUploadInfo 接口指定内网上传文件信息，并获取文件上传链接和 Header 信息。成功获取到上述信息后，按照链接及 Header 进行请求即可完成内网上传。资源上传时指定的 StoreKey 即为资源在 veImageX 内的资源 URI，资源上传完成后，您可以使用资源 URI 进行后续图片和访问。
veImageX 提供了配套的服务端 SDK，支持多种编程语言，帮助您更方便的调用 API。
步骤二：图片处理与访问
- 登录 veImageX 控制台，进入处理配置页面，根据您想要对图片做的处理项，如裁剪、高斯模糊等，创建对应的模板。新建模板时需要配置模板的名称，作为后续拼接图片 URL 的主要组成部分之一。详细操作请参考新建模板。
- 获取结果图地址：通过控制台、自拼接、OpenAPI 获取模板处理后的结果图地址。
- 控制台获取结果图地址（前期调试时推荐使用）：参考获取资源地址，获取模板处理后的结果图地址。
- 自拼接获取获取结果图地址：图片地址为
http(s)://域名/图片URI~模板配置。- 模板配置的组成规则为
模板名称:{可选参数}.目标图片格式。 - 可选参数以
:打头，如果包含多个参数，参数间需要使用:分隔，参数仅支持数字，不能为空。 - 目标图片格式支持 image、jpeg、png、webp 等，其中 image 表示维持原图片的格式。
- 模板配置的组成规则为
- OpenAPI 获取结果图地址：参考 GetResourceURL，获取结果图地址。