`POST https://mediakit.cn-beijing.volces.com/api/v1/tools-sync/invert-image` 本 API 用于提交一个同步的图像负片任务，对输入图像执行负片（反相）效果，将图像的明暗关系与颜色映射为原图的相反效果，即明暗反转、色彩转为补色。适用于创意视觉生成、内容二次创作、自动化图像处理、教学演示及艺术风格化等多种场景。这是一个同步接口，处理结果将直接在本接口的响应体中返回。

说明

如需了解该功能的详细说明及应用，请参阅图像负片。

## 请求参数 ### Header 参数 |参数 |类型 |是否必选 |示例值 |描述 | |---|---|---|---|---| |`Authorization` |String |是 |`Bearer {Your_API_Key}` |格式为 `Bearer {Your_API_Key}`。请参考[基础概念及准备工作](https://docs.volcengine.com/docs/6448/2300661)获取 API Key。 | ### Body 参数 |参数 |类型 |是否必选 |示例值 |描述 | |---|---|---|---|---| |`image_url` |String |是 |`https://example.com/source.png` |待处理的图片 URL。

* **图像来源**：支持公网 HTTP/HTTPS URL、本地上传 (`mediakit://`)、火山引擎对象存储 (`tos://`) 三种输入协议。关于各协议的具体说明和使用示例，请参阅[多源媒体输入与本地上传](https://docs.volcengine.com/docs/6448/2536893)。

* **文件大小**：建议单张图片不超过 35 MB。

* **支持格式**：支持 `.png`、`.jpg`、`.jpeg`、`.webp` 等主流图像格式。仅支持处理静图。

* **输入分辨率限制**：宽和高均不得超过 10000 像素。 | |`output_format` |String |否 |`webp` |输出图片的格式。默认为 `original`。

* `original`：保持与原图一致的格式。

* `png`

* `jpeg`

* `webp` | |`queue_id` |String |否 |`q00a9731598092652e4a95292434198` |任务提交的目标队列 ID。如不传，默认会使用系统自动创建的队列 ID。您可以将不同业务或优先级的任务提交到不同的队列，以实现按队列对应的项目进行分账。您可以在 AI MediaKit 控制台队列管理页面创建和管理队列，系统会自动分配一个队列 ID。详情请参考[项目与队列管理](https://docs.volcengine.com/docs/6448/2519520)。 | ## 请求示例以下示例演示了如何为一个图片提交负片处理任务，并指定输出为 WebP 格式。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools-sync/invert-image' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "image_url": "https://example.com/input_image.jpg", "output_format": "webp" }' ``` ## 响应说明调用 API 后，您会收到一个同步响应，表明任务是否已成功提交。 ### 响应参数 |**参数** |**类型** |**描述** | |---|---|---| |`success` |Boolean |任务是否成功提交。

* `true`：任务已成功提交到后台处理队列。

* `false`：请求存在错误，任务提交失败。请检查 `error` 字段以获取详细信息。 | |`result` |Object |包含图像处理结果的对象。详见下文 [Result 结构](https://docs.volcengine.com/docs/6448/2515368#9bd0bace)。 | |`task_id` |String |任务的唯一标识符。您可以使用此 ID 来查询任务状态或进行问题排查。 | |`request_id` |String |本次 API 请求的唯一标识符，可用于问题排查。 | |`error` |Object |错误详情对象，仅在 success 为 false 时返回。详见下文 [Error 结构](https://docs.volcengine.com/docs/6448/2515368#ee49a790)。 | #### Result 结构 |**参数** |**类型** |**描述** | |---|---|---| |`image_url` |String |处理后的图片文件下载地址。该地址的有效期为 **24 小时**，请务必及时保存产物。 | |`image_size` |Integer |生成图像的大小，单位为字节。 | |`image_format` |String |生成图像的格式，例如：webp。 | |`image_width` |Integer |生成图像的宽度，单位为 px。 | |`image_height` |Integer |生成图像的高度，单位为 px。 | #### Error 结构 |**参数** |**类型** |**描述** | |---|---|---| |`code` |String |具体的错误码，用于程序化识别错误类型。例如：`InvalidParameter`。关于各错误码的详细信息，请参阅[错误码](https://docs.volcengine.com/docs/6448/2300662)。 | |`type` |String |错误的宏观类型。例如：BadRequest。 | |`message` |String |对错误的详细描述，可用于开发调试。 | ### 响应示例成功响应示例： ```JSON { "success": true, "task_id": "amk-tool-invert-image-1234567", "result": { "image_url": "https://example.volcvideo.com/inverted_output.webp?auth_key=1775271661-...", "image_size": 910234, "image_format": "webp", "image_width": 1920, "image_height": 1080 }, "request_id": "021778401180935fdbd0ff1ce00652c087a478b3f62d63b5dbf0f", "expires_at": 1775271661 } ``` 失败响应示例： ```JSON { "success":false, "task_id":"amk-tool-invert-image-940034677250", "task_type":"invert-image", "error":{ "code":"InvalidParameter", "type":"BadRequest", "message":"validating root: required: missing properties: [\"image_url\"]" }, "request_id":"202607291022287DC463A3C5D182BCEE73" } ```