You need to enable JavaScript to run this app.
导航
veImageX 内网数据互访
最近更新时间:2025.06.26 20:25:46首次发布时间:2025.03.20 19:35:22
复制全文
我的收藏
有用
有用
无用
无用

veImageX 面向企业用户提供灵活、高效的一站式图片处理解决方案。您可借助 veImageX 的上传、托管、智能处理和分发能力,批量处理图像、文档等各类素材。在一些业务场景下,需要通过内网访问 veImageX 内的资源,或者通过 veImageX 处理分发一些内网产生的资源,本文旨在为您介绍在内网读写访问的最佳实践。

业务场景

本章节介绍内网数据互访的常见业务场景。

场景一:云上 VPC 服务通过内网读写 veImageX 资源

火山引擎私有网络(VPC,Virtual Private Cloud)为云上资源构建隔离的、自主配置和管理的虚拟网络环境。在一些数据训练、业务上云后,需要内网访问存入 veImageX 的资源,实现安全、高效的数据访问。

场景二:通过 veImageX 分发其他云服务产生的资源

使用火山引擎其他云服务生产的资源,veImageX 可以通过内网访问和上传,进行图片处理、图片分发。
例如:

  • 火山引擎 ECS 云服务器 云服务器上生产的资源,比如 GPU 服务器上的 AIGC 大模型生产的资源,可通过内网上传到 veImageX 存储,通过 veImageX 的 CDN 进行分发。结合 veImageX 丰富的实时处理能力,可进一步对图片进行处理,比如:缩放、裁剪、图文水印、画质增强等。
    Image
  • 资源已经存储在火山引擎对象存储 TOS,还希望使用 veImageX 的图片处理能力。可以将 ECS 云服务器作为中转站,内网读取 TOS 资源,再通过内网上传到 veImageX 存储。
    Image

前提条件

操作指南

场景一:云上 VPC 服务通过内网读写 veImageX 资源

步骤一:将资源上传到 veImageX(可选)

通过公网上传方式,将资源上传到 veImageX。你可以通过服务端或客户端上传资源,详情参看 veImageX 上传最佳实践

步骤二:通过 VPC 读取 veImageX 内的资源

说明

veImageX 在华北 2 地域提供服务,根据您的 VPC 区域不同,访问方式不同:

  • 如果您的私有网络 VPC 所属的区域也是华北 2,则可通过创建一个接口终端节点,使用 veImageX VPC 中部署的服务资源。
  • 如果您在其他地域(例如华东 2)创建了 VPC,想要访问 veImageX 服务,就需要购买云企业网来实现跨地域的网络互通。云企业网是火山引擎提供的一种网络互联服务,它可以帮助用户建立跨地域、跨账号的私有网络互通,因此需要购买云企业网来打通华北 2 和华东 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。

步骤二:图片处理与访问

  1. 登录 veImageX 控制台,进入处理配置页面,根据您想要对图片做的处理项,如裁剪、高斯模糊等,创建对应的模板。新建模板时需要配置模板的名称,作为后续拼接图片 URL 的主要组成部分之一。详细操作请参考新建模板
  2. 获取结果图地址:通过控制台、自拼接、OpenAPI 获取模板处理后的结果图地址。
    • 控制台获取结果图地址(前期调试时推荐使用):参考获取资源地址,获取模板处理后的结果图地址。
    • 自拼接获取获取结果图地址:图片地址为 http(s)://域名/图片URI~模板配置
      • 模板配置的组成规则为 模板名称:{可选参数}.目标图片格式
      • 可选参数以 : 打头,如果包含多个参数,参数间需要使用 : 分隔,参数仅支持数字,不能为空。
      • 目标图片格式支持 image、jpeg、png、webp 等,其中 image 表示维持原图片的格式。
        Image
    • OpenAPI 获取结果图地址:参考 GetResourceURL,获取结果图地址。