附加组件 2.0 支持批量处理功能。通过批量处理图像，您可以节省带宽和时间，降低使用成本并提高运行效率。相较于离线转码功能，批量处理功能具备多样化的输入和输出形式，包括 JSON、文本和文件格式，适用于电商平台批量优化商品图等需要对海量图片进行一致性处理的场景。本文介绍如何使用批量处理功能。

计费说明

该能力涉及的图片计费项与您所选用的附加组件有关，详见附加组件计费说明。

注意事项

• 一个队列可提交多条任务，一个任务内提交的待处理图片建议最多不超过 10 万条。
• 开启批量处理任务后，在执行该任务内具体图片时将生成对应条目（Entry），即一个图片执行任务对应一个条目。

前提条件

• 已创建服务，且服务可正常使用。

• 已开通智能处理计费配置。

• 如需完成以下操作，确保已创建模板。详见新建模板。

  • 处理输入图像：如果输入图像不符合输入限制，您可以通过模板来压缩图片大小或变更图片格式，再将处理后的图片作为输入图像。
  • 处理生成图像：对生成的图像进行二次处理，例如添加水印或调整分辨率。

  如无上述需求，使用默认生成的获取原图模板获取结果图访问地址即可。

使用流程

步骤一：新建并启动任务队列

veImageX 在每个账号内置了一个默认任务队列，如无特殊需求，您可直接使用默认任务队列。

1. 登录 veImageX 控制台。

2. 在左侧导航栏，选择组件市场 > 批量处理。

3. 单击新建任务队列，在弹窗中完成以下配置，并单击确定。

   配置项	说明
   任务队列名	任务名称。
   任务描述	任务作用描述。
   属性	选择附加组件。

4. 在批量处理页面的状态列，单击启动，启动该新建的任务队列。

   说明

   若一个队列提交了多个任务时，任务将按照提交先后顺序执行批量处理。

您也可以通过调用以下接口，实现上述操作。

• 调用 CreateImageAIProcessQueue 接口，新建任务队列。
• 调用 UpdateImageAIProcessQueueStatus 接口，将 Status 取值设置为 Running，启动任务队列。

（可选）步骤二：回调配置

该回调配置所应用范围为整个任务队列内所有已提交任务，但仅当各任务内每个 URL/URI 资源处理成功或失败时，才会向回调 URL 发送回调内容。

1. 在批量处理页面，打开任务队列回调配置列的开关。

2. 在回调配置弹窗中，完成以下配置并单击确定。

   配置项	说明
   回调类型	仅支持普通 API。
   回调URL	支持自定义回调协议（http 或 https），并输入回调地址，接收图片处理结果。回调内容详见回调。 说明 若该 URL 未成功接收回调内容，您可以通过查询任务详情 > 手工触发回调来手动向该 URL 发送回调内容。
   回调格式	按需选择回调格式： XML JSON

您也可以通过调用 CreateImageAIProcessQueue 或 CreateImageAITask 接口设置回调配置。其中，CreateImageAITask 的回调配置优先级更高。

步骤三：提交任务

1. 在任务队列的操作列，单击提交任务。

2. 在弹窗中，完成以下配置并单击确定。
   

   配置项	说明
   服务名称	选择一个该账号下已创建的服务。
   提交类型	选择图像地址类型，支持以下两种类型。 URL (合法可访问即可)：上传公网可访问的 URL，例如 https://example.com/static/demo1.png。 URI (必须归属本服务下)：上传当前服务下不包含 tos-*-i-* 前缀的存储 URI，例如存储 URI 为 tos-m*a-i-0ksq****qe/image-a/example.jpg，则传入 image-a/example.jpg。 说明 当使用 ImageX-SeeDream 生图方案附加组件时，图像地址为可辅助生成图像的参考图 URL 或 URI 地址。如需仅根据提示词生成图像，请调用 AIProcess 或 CreateImageAITask 接口。详见方式一：通过 API 调用。
   处理后 StoreKey	处理后 StoreKey 的生成方式。 目前仅支持使用 veImageX 服务随机生成的处理后 StoreKey。
   文件上传	在 TXT 或 CSV 文件内，根据选择的提交类型，指定图像的 URL 或 URI 地址，并拖拽上传。每行填写一个，以换行分隔。为避免因数据过多导致处理失败，建议最多不超过 10 万条。 说明 若您配置了上传 Content-Type 限制，则文件的格式需在服务的 Content-Type 白名单内，否则，无法成功上传。 当使用 ImageX-SeeDream 生图方案附加组件时，上传的文件需遵循以下格式：每行可包含 1 到 10 个参考图地址，并使用英文逗号（,）分隔，但地址本身不包含英文逗号。 示例一：在文件的一行内写入 a.png,uridemo.png，表示根据提示词和参考图 a.png、uridemo.png 生成一次图像。 示例二：在文件中分两行写入以下内容，表示根据提示词和参考图 a.png 生成一次图像，再根据提示词和参考图 uridemo.png 生成一次图像。 a.png uridemo.png
   工作流模板ID	选择工作流模板 ID。
   模板配置参数	输入 JSON 格式的模板配置参数。