为了您便捷的使用历史版本图片处理能力，请您在开启自定义处理样式开关后，在样式管理自定义添加您需要实现的功能参数配置。历史版本图片处理包含 A 版、Q 版和 T 版共 3 种类型，各版本支持配置的参数及参数配置规则请参考各版本用法说明。

前提条件

• 已完成新建服务且服务状态正常
• 已获取待处理源图像访问 URL

操作步骤

开启自定义处理样式

录 veImageX 控制台，进入服务管理页面。

2. 选择要配置的服务，单击基础配置按钮。
3. 在高级配置页签选择自定义处理样式，将状态变更为开启，并选择处理参数为 Q 版或 T 版，单击确认保存修改。

   说明

   由于 T 版和 Q 版能力冲突，需要指定以哪种用法生效，该选项不影响 A 版的正常使用。

   
4. 开启自定义处理样式后，即可参考各版本用法说明在请求中携带图片处理参数对图片进行处理；也可根据您的需要新建自定义样式。

   说明

   自定义样式可以与图片处理参数同时使用。同时使用时，需要在控制台开启开关，且有一些使用限制，详情参看兼容自定义样式和处理参数。

新建自定义样式

1. 开启自定义处理样式后，单击样式管理按钮。
   

2. 单击新建样式按钮，在弹出的新建样式配置框中参考下表完成配置。

   配置项	说明
   样式名称	可用于备注当前样式所在版本以及包含的图片处理能力。最多不超过 256 个字符，支持填写数字、大小写字母、下划线、短横线、小数点。
   代码	参考各版本用法说明填写具体的图片参数配置，您可在右侧预览框查看参数配置是否生效以及具体配置效果。 例如，设置 A 版等比缩放，指定图片的高为 100px 的图片处理样式，样式名称为 A_Test，参数配置为image/resize,h_100。此时访问该处理图的格式为：https://域名/存储URI?x-tos-process=style/A_Test。具体访问实现可参考示例说明。

3. 单击确定按钮，保存当前配置。
   

访问设置

1. 在自定义处理样式-样式配置页面，单击访问设置按钮。

2. 在弹出的访问设置配置框中参考下表完成配置。

   配置项	说明
   原图保护	开启原图保护后，将无法通过源文件 URL 直接访问原图，以阻止恶意用户对该存储服务下原图的请求。开启后，可以使用携带样式参数/分隔符的请求访问处理后的图片（无需使用鉴权）。 例如，您可以通过以下方式访问开启原图保护的处理后图片： 使用携带样式参数的文件 URL 访问，格式为 https://域名/存储URI?x-tos-process=style/stylename 使用携带分隔符（以@为例）的文件 URL 访问，格式为 https://域名/存储URI@stylename 注意 携带鉴权参数的源文件 URL 也无法直接访问开启了原图保护的原图。 由于开启原图保护后，将作用于整个服务。所以强烈建议您对开启原图保护的服务仅存储需要保护原图的文件，其他文件使用其他服务存储。
   自定义分隔符	为了进一步简化图片处理 URL，veImageX 支持自定义分隔符，配置后您可使用分隔符代替?x-tos-process=style/。 支持设置的分隔符为：~ @ $ ^ & * ( ) - _ / ! + = { } [ ] | : ; " ' , < > 例如，分隔符设置为@，则图片处理访问 URL 为http(s)//:域名/存储URI@stylename 注意 一旦添加分隔符则无法删除，请谨慎操作。

   

管理样式

具体操作及说明如下表所示。

导入导出样式

您可以导出源服务中已创建的样式，并将样式导入到目标服务，便于在目标服务中快速应用样式来处理图片文件。

1. 在源服务中导出样式。
   1. 在源服务管理页面，选择自定义样式处理 > 样式管理。
   2. 在样式配置页面，勾选待导出的样式后，单击上方操作栏的导出样式按钮。
   3. 您的自定义样式将自动保存至本地，样式文件名称默认为 export.imagey。
2. 在目标服务导入样式。
   1. 在目标服务管理页面，选择自定义样式处理 > 样式管理。
   2. 在样式配置页面，单击导入样式。
   3. 在弹出的对话框选择已导出的样式文件，然后单击打开。
   4. 样式导入完成后，即可在目标服务中使用这些样式处理图片文件。

兼容自定义样式和处理参数

如果您想组合使用自定义处理样式和拼接已有处理参数这两种方式，可以通过开启兼容开关实现。

1. 开启自定义处理样式后，单击样式管理按钮。
   
2. 在样式配置页面，开启兼容样式与处理参数同时生效开关。开启后，可以兼容样式和处理参数同时生效，比如使用 T 版，自定义旋转的样式为 -rotate，对比度的处理参数为 imageMogr2/contrast/20，在图片访问 URL 中，支持 xxx-rotate?imageMogr2/contrast/20 旋转和对比度同时生效的用法，关闭开关后则仅对样式 -rotate 生效。

   说明

   • 访问时，自定义样式参数必须拼接在处理参数前。
   • 一次图片处理中，自定义样式只能使用一个，图片处理参数可以拼接多个。
   

示例说明

• 样式配置：设置 A 版等比缩放，指定图片的高为 100px 的图片处理样式，样式名称为 A_Test，参数配置为image/resize,h_100。
• 访问配置：设置自定义分隔符为@。
• 原图访问地址：https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg

最终处理图访问 URL：https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg@A_Test