AI MediaKit 图像擦除修复工具，能够自动检测并移除图片中的文字或常见图标，并利用智能填充技术对擦除后的区域进行修复，使其与背景自然融合，适用于内容清洗、素材二次创作、AIGC 内容修正等多种场景。本篇开发指南将引导您： * 快速体验通过一次 API 调用去除图片中的所有文字。 * 掌握不同擦除场景的使用方法：擦除指定文字、擦除图标。 ## 效果示例通过图像擦除修复工具，您可以实现以下效果： ![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/9349e182cfa447439cc7c6c3b1917042) ## 快速体验：一键去除图片中的所有文字图像擦除修复是一个**同步任务**，您发起的请求会直接在响应中返回处理结果，无需轮询。默认的擦除场景是**全屏文字擦除**。 ### 准备工作 1. **获取访问凭证**：在开始之前，访问 AI MediaKit 控制台 [API Key 管理页面](https://console.volcengine.com/imp/ai-mediakit/settings)，创建并获取 **AI MediaKit API Key**（用于媒体处理功能鉴权）。 2. **准备图像文件**：准备一张带有文字的图片，并将其上传至公网可访问的服务器或[视频点播服务](https://www.volcengine.com/docs/4/2834?lang=zh)中，以获取可供 API 调用的 URL。 ### 操作流程您只需调用一次[提交图像擦除修复任务 API](https://docs.volcengine.com/docs/6448/2479104)，即可在 API 的响应体中直接获取处理后的图片地址。 #### 步骤 1：提交任务并获取结果可直接复制以下 cURL 命令，向 API 提交一个擦除任务。本示例不传入任何擦除参数，系统将默认执行**全屏文字擦除**。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools-sync/erase-image' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {Your_API_Key}' \ --data '{ "image_url": "https://example.com/with_watermark.jpg" }' ```

说明

需替换参数：

将 {Your_API_Key} 替换为您的有效 API Key。

将 image_url 替换为您真实的图片地址。

#### 步骤 2：查看响应由于是同步接口，请求成功后，您会在几秒内收到包含最终结果的响应。您可以直接从 `result.image_url` 字段获取擦除修复后图片的下载地址（有效期为 24 小时）。 ```JSON { "success": true, "task_id": "amk-tool-erase-image-123456", "request_id": "20240520203000ABCDEFG12345", "expires_at":1779183261, "result": { "image_url": "https://output.volcvideo.com/erased_image.webp?auth_key=...", "image_size": 51200, "image_format": "webp", "image_width": 1920, "image_height": 1080 } } ``` ## 进阶功能您可以通过设置 `standard_scene` 参数，更精确地控制擦除的目标。 ### 擦除图标如果您需要移除的目标是图标（如 Logo、台标），可以将 `standard_scene` 参数设置为 `full_screen_icon_erase`。 #### 示例：擦除图片中的所有常见图标 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools-sync/erase-image' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {Your_API_Key}' \ --data '{ "image_url": "https://example.com/with_logo.jpg", "standard_scene": "full_screen_icon_erase" }' ``` ### 擦除文字当您需要精确擦除图片中某些特定的文字水印时，可以使用 `standard_erase_text` 参数。此功能仅在 standard_scene 为 `full_screen_text_erase` 时生效。 * **擦除所有文字**：使用默认场景 (`full_screen_text_erase`)，且不提供 `standard_erase_text` 参数。 * **擦除指定文字**：使用默认场景，并通过 `standard_erase_text` 参数指定需要擦除的文字内容。系统会精确查找并擦除匹配的文字。 #### 示例：擦除图片中所有“内部资料”字样 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools-sync/erase-image' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {Your_API_Key}' \ --data '{ "image_url": "https://example.com/confidential.jpg", "standard_scene": "full_screen_text_erase", "standard_erase_text": "内部资料" }' ``` ### 擦除指定区域当您需要擦除的目标（如杂物、路人）不属于文字或图标，或者需要对图像中一块精确的区域进行修复时，可以将 `standard_scene` 参数设置为 `selected_area_erase`。该场景下，您需要通过以下两种方式来定义擦除区域。您可以单独使用，也可以组合使用（此时系统将擦除二者定义区域的并集）： * **坐标框 ** **`selected_area`**：通过传入一个矩形框的归一化坐标来指定擦除区域。这种方式适用于擦除规则的矩形区域。坐标系以图片左上角为原点 (0, 0)，右下角为 (1, 1)。您需要提供矩形左上角 (`top_left_x`, `top_left_y`) 和右下角 (`bottom_right_x`, `bottom_right_y`) 的坐标。 * **遮罩图 ** **`mask_url`**：通过提供一张黑白遮罩图的 URL 来指定任意形状的擦除区域。这种方式较为灵活，适用于擦除不规则的物体。

遮罩图 (Mask) 说明

您可以将“遮罩图”理解为一张指导系统进行擦除的“蒙版”或“模板”。它是一张与原图等大的黑白图片：

白色区域：对应您想从原图中擦除的部分。

黑色区域：对应您想在原图中保留的部分。

通过绘制不同形状的白色区域，您可以实现擦除不规则物体，比使用矩形框更加灵活。

#### 示例 1：通过坐标框擦除指定区域以下示例擦除图像左上部一块矩形区域（横向 10%~50%、纵向 10%~40%）。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools-sync/erase-image' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {Your_API_Key}' \ --data '{ "image_url": "https://example.com/with_area.png", "standard_scene": "selected_area_erase", "selected_area": { "top_left_x": 0.1, "top_left_y": 0.1, "bottom_right_x": 0.5, "bottom_right_y": 0.4 } }' ``` #### 示例 2：通过遮罩图擦除不规则区域以下示例通过遮罩图 `mask_url` 指定擦除区域。遮罩图中白色部分即为需要擦除的区域，需与输入图分辨率一致。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools-sync/erase-image' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {Your_API_Key}' \ --data '{ "image_url": "https://example.com/with_area.png", "standard_scene": "selected_area_erase", "mask_url": "https://example.com/mask.png" }' ``` ## 参考信息 ### 应用场景 * **内容清洗与分发**：在内容分发前，自动去除图片中其他平台的 Logo、水印或宣传语，保护版权或满足渠道要求。 * **素材二次创作**：在进行海报、视频封面等设计时，擦除原始素材中的多余元素（如路人、杂物），获得干净的背景素材。 * **AIGC 内容修正**：当 AIGC 生成的图片中出现不符合预期的文字或物体时（负向提示词失效），可利用本功能进行高质量的无痕擦除。 * **商品图处理**：擦除商品图背景中的杂乱物体，或移除模特身上的临时标记，使商品图更专业、美观。 ### 使用限制 |**限制项** |**说明** | |---|---| |**输入图像限制** |* **图像来源**：支持公网 HTTP/HTTPS URL、本地上传 (`mediakit://`)、火山引擎对象存储 (`tos://`) 三种输入协议。关于各协议的具体说明和使用示例，请参阅[多源媒体输入与本地上传](https://docs.volcengine.com/docs/6448/2536893)。

* **文件大小**：单张图片不得超过 10 MB。

* **支持格式**：支持 `.png`、`.jpg`、`.jpeg`、`.webp`、`.tiff`、`.bmp` 和 `.heic`。

* **图像输入分辨率**：

* 不得小于 10x10 像素

* 不得超过 2560×1440 像素（宽x高） | ## 相关 API 文档 * [提交图像擦除修复任务 API](https://docs.volcengine.com/docs/6448/2479104)