AI MediaKit 的图像暗水印工具，可以在不明显破坏图片完整性与画质的前提下，将一段自定义文本信息隐藏式地嵌入图片中。这项技术对于版权保护、AIGC 生图合规、传播链路追踪、搬运取证等场景至关重要。即使图片经过缩放、压缩、转码等处理，嵌入的暗水印信息仍有很大概率能被成功提取，为版权追踪与维权提供有力证据。本篇开发指南将引导您： * 理解图像暗水印的工作流程。 * 快速上手，通过调用 API 为图片添加一个暗水印，并从处理后的图片中将其成功提取出来。 * 掌握如何通过参数选择模型版本与暗水印强度。 ## 工作原理图像暗水印的核心流程包含“添加”和“提取”两个主要环节： 1. **添加暗水印**：将原始图片和一段自定义文本（水印内容）作为输入，经过算法处理，生成一张肉眼看不出差异、但已包含隐藏信息的新图片。添加时需显式指定暗水印模型版本。 2. **提取暗水印**：将疑似泄露或被搬运的图片作为输入，通过暗水印提取 API 进行分析，还原出当初嵌入的文本信息。提取时必须使用与添加时**相同的模型版本**。 ## 快速体验：添加并提取一个图像暗水印本节将演示如何通过 API 调用，完成为图片添加暗水印及从图片中提取暗水印的完整流程。图像暗水印的添加与提取均为**同步任务**，您发起的请求会直接在响应中返回处理结果。 ### 准备工作 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。 ### 操作流程添加并提取暗水印是一个包含两个同步任务的流程，核心步骤如下： 1. **提交暗水印添加任务并获取产物**：调用[提交图像暗水印添加任务 API](https://docs.volcengine.com/docs/6448/2664209)，在响应的 `result` 字段中直接获取已添加暗水印的图片 URL（`image_url`）。 2. **提交暗水印提取任务并获取结果**：调用[提交图像暗水印提取任务 API](https://docs.volcengine.com/docs/6448/2664208) 并传入上一步获得的图片 URL 与**相同的 ** **`tool_version`**，在响应的 `result` 字段中获取提取出的水印内容（`watermark_content`）。 #### 第 1 步：提交图像暗水印添加任务首先，调用[提交图像暗水印添加任务 API](https://docs.volcengine.com/docs/6448/2664209) 来为一张图片嵌入您指定的文本信息。可直接复制以下 cURL 命令提交任务。本示例使用 `adapt` 模型版本，将文本 `"copyright-2026"` 作为暗水印内容嵌入图片中。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools-sync/add-image-invisible-watermark' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "image_url": "https://vod-ai-test.tos-cn-beijing.volces.com/demo/source_image.jpg", "tool_version": "adapt", "watermark_content": "copyright-2026" }' ```

说明

将 {Your_API_Key} 替换为您的真实 API Key。

image_url：将其替换为您自己的图片地址。

tool_version：暗水印模型版本，本示例使用 adapt。请记录此版本，提取时必须使用同一版本。

watermark_content：自定义暗水印文本内容，最长 128 字符。

由于是同步接口，请求成功后，您会在响应的 `result` 字段中直接获取已添加暗水印的图片下载地址（`image_url`，有效期为 24 小时），请务必及时保存。成功响应示例如下： ```JSON { "success": true, "task_id": "amk-tool-add-image-invisible-watermark-1703200", "task_type": "add-image-invisible-watermark", "request_id": "20260415150000F6DE4C24A6A0D94B7FF2", "result": { "image_url": "https://example.volcvideo.com/watermarked_output.png?auth_key=...", "image_size": 875321, "image_format": "png", "image_width": 2048, "image_height": 1536 }, "expires_at": 1776274800 } ``` #### 第 2 步：提交图像暗水印提取任务获取到已添加暗水印的图片 URL 后，调用[提交图像暗水印提取任务 API](https://docs.volcengine.com/docs/6448/2664208) 来解析其中隐藏的信息。使用您在上一步中获得的 `image_url`，并传入与添加时**相同的 ** **`tool_version`**，然后提交请求。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools-sync/extract-image-invisible-watermark' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "image_url": "https://example.volcvideo.com/watermarked_output.png?auth_key=...", "tool_version": "adapt" }' ```

说明

将 {Your_API_Key} 替换为您的真实 API Key。

将 image_url 替换为您在第 1 步获得的、已添加暗水印的图片 URL。

tool_version 必须与添加暗水印时使用的版本一致，否则可能无法正确提取。

请求成功后，您会在响应的 `result.watermark_content` 字段中直接获取提取出的暗水印内容。成功响应示例如下： ```JSON { "success": true, "task_id": "amk-tool-extract-image-invisible-watermark-1703201", "task_type": "extract-image-invisible-watermark", "request_id": "20260415150030F6DE4C24A6A0D94B7FF2", "result": { "watermark_content": "copyright-2026" }, "expires_at": 1776274830 } ``` #### 第 3 步：比对水印内容将第 2 步提取到的水印内容（`"copyright-2026"`）与第 1 步嵌入的水印内容进行比对。如果两者一致，即证明该图片的来源得到了成功校验。 ## 进阶使用 ### 调整暗水印强度在调用[提交图像暗水印添加任务 API](https://docs.volcengine.com/docs/6448/2664209) 时，可通过 `strength_level` 参数来调整暗水印的强度。强度越高，抵抗攻击（缩放、压缩、转码等处理）的性能越强，但对原始画面的潜在影响也相对越大（暗水印本质仍是对图像像素数据的修改）。 * `low`：低强度。适用于纯色图场景以及对图像质量要求较高的场景。 * `medium`：（默认值）中强度。在画质与抗攻击性之间取得平衡，适用于大多数场景。 * `strong`：高强度。适合图像纹理丰富时使用，抗攻击性最强。 #### 示例：添加一个高强度的暗水印并指定输出格式 ```JSON { "image_url": "https://example.com/source.jpg", "tool_version": "adapt_resize", "watermark_content": "channel-A-user-10086", "strength_level": "strong", "output_format": "webp", "output_quality": 85 } ``` ## 参考信息 ### 使用限制 |限制项 |说明 | |---|---| |输入图像 |* **图像来源**：支持公网 HTTP/HTTPS URL、本地上传 (`mediakit://`)、火山引擎对象存储 (`tos://`) 等输入协议。关于各协议的具体说明和使用示例，请参阅[多源媒体输入与本地上传](https://docs.volcengine.com/docs/6448/2536893)。

* **支持格式**：`.png`、`.jpg`、`.jpeg`、`.webp` 等常见主流图像格式。 | |水印内容 |* **格式**：自定义文本内容。

* **长度**：最长 128 字符；若均为中文文字，建议不超过 42 个字。 | |兼容性 |暗水印提取仅支持提取由 AI MediaKit 图像暗水印添加 API 嵌入的水印，且提取时使用的 `tool_version` 必须与添加时一致；无法提取通过其他第三方工具添加的任何形式的暗水印。 | ### 计费说明图像暗水印工具的费用根据**成功调用次数**进行计算。无论是添加暗水印还是提取暗水印，每次成功的 API 调用都将计为一次处理。关于详细的计费标准和计费示例，请参阅[图像智能编辑（按次计费）](https://docs.volcengine.com/docs/6448/2486470#49e8d2b6)。 ## 相关 API 文档 * [提交图像暗水印添加任务 API](https://docs.volcengine.com/docs/6448/2664209) * [提交图像暗水印提取任务 API](https://docs.volcengine.com/docs/6448/2664208)