AI MediaKit 提供**人像抠图**和**绿幕抠图**两种工具，能够将视频中的主体（人物、物品等）与背景精准分离，生成背景透明或纯色背景的视频素材，为虚拟背景替换、创意合成、电商展示等后期处理场景提供强大支持。本篇开发指南将引导您快速上手，通过 API 实现视频的自动化抠图处理。 ## 工具说明 AI MediaKit 为**人像抠图**和**绿幕抠图**分别提供了独立的 API，但它们遵循完全相同的异步任务流程，并使用同一个 API 查询任务结果。 |**工具** |**API** |**核心能力** | |---|---|---| |**绿幕抠图** |[提交视频绿幕抠图任务 API](https://docs.volcengine.com/docs/6448/2464612) |对以绿幕或纯色为背景的视频进行抠图，自动识别并保留主体（如人物、物品、动物等等），同时移除背景，最终生成一个透明背景或纯色背景的视频。 | |**人像抠图** |[提交视频人像抠图任务 API](https://docs.volcengine.com/docs/6448/2464608) |自动识别视频中的人物主体，移除原始背景，并生成一个透明背景或纯色背景的视频文件。 | ## 效果预览 |工具 |输入视频 |抠图视频 | |---|---|---| |绿幕抠图 |

| |人像抠图 |

| ## 快速入门：一键实现人像抠图本节将以**人像抠图**为例，演示完整的 API 调用流程。 ### 准备工作 1. **获取访问凭证**：在开始之前，访问 AI MediaKit 控制台 [API Key 管理页面](https://console.volcengine.com/imp/ai-mediakit/settings)，创建并获取 **MediaKit API Key**（用于媒体处理功能鉴权）。 2. **准备视频文件**：准备一个待处理的视频文件，并将其上传至公网可访问的服务器或[视频点播服务](https://www.volcengine.com/docs/4/2834?lang=zh)中，以获取可供 API 调用的 URL。 ### 操作步骤视频抠图是一个异步任务，整体流程如下： 1. 成功调用 `POST /api/v1/tools/matte-portrait-video` 后，API 将返回一个任务 ID 。 2. 您可以轮询 `GET /api/v1/tasks/{task_id}` ，直到任务状态`status` 变为 `completed`；或者使用[事件回调](https://docs.volcengine.com/docs/6448/2288701)自动接收任务状态变化。 3. 任务完成后，您可解析 `result` 字段，在 `video_url` 字段处获取背景透明视频的下载地址。 #### 第 1 步：提交人像抠图任务可直接复制以下 cURL 命令提交一个人像抠图任务。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/matte-portrait-video' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "video_url": "https://example.com/your_portrait_video.mp4" }' ```

说明

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

将 video_url 替换为您自己的视频文件地址。

请求成功后，您会收到如下包含 `task_id` 的响应，请保存此 ID 用于后续查询。 ```JSON { "success": true, "task_id": "amk-tool-matte-portrait-video-123456789", "request_id": "20240521100000ABCDEFG12345" } ``` #### 第 2 步：获取抠图结果您需要轮询[查询任务信息 API](https://docs.volcengine.com/docs/6448/2278532)，直到任务状态 `status` 变为 `completed`。 ```Bash curl -X GET 'https://mediakit.cn-beijing.volces.com/api/v1/tasks/{task_id}' \ -H 'Authorization: Bearer {Your_API_Key}' ```

说明

将 URL 末尾的 {task_id} 替换为第 1 步返回的任务 ID。

任务成功完成后，您将收到包含最终结果的响应。`result.video_url` 即是抠图后生成的背景透明视频的下载地址（默认输出为 **WebM** 格式，有效期为 **24** 小时）。 ```JSON { "success": true, "task_id": "amk-tool-matte-portrait-video-123456789", "status": "completed", "result": { "video_url": "https://example.volcvideo.com/matted_output.webm?auth_key=...", "resolution": "1080p", "duration": 15.5 }, ... } ```

说明

如果您的视频是在绿幕或纯色背景下拍摄的，可以调用提交视频绿幕抠图任务 API以获得更精细的效果。实现流程与人像抠图类似，仅需将 API Endpoint 更换为 POST /api/v1/tools/matte-greenscreen-video。

## 进阶使用 ### 选择输出格式与背景颜色视频抠图工具支持三种输出格式，您可以通过 `format` 参数在提交任务时指定： * `WEBM`（默认）：输出**透明背景**视频，兼容性好、文件体积较小。 * `MOV`：输出**透明背景**视频，提供无损 Alpha 通道，文件体积较大。 * `MP4`：输出**纯色背景**视频。当选择 MP4 时，您还可以通过 `background_color` 参数指定背景颜色，支持 `black`（黑色）、`white`（白色）、`green`（绿色）。两种抠图工具的默认背景色不同： * 绿幕抠图：`format` 为 `MP4` 且未传 `background_color` 时，默认背景色为 `black`（黑色）。 * 人像抠图：`format` 为 `MP4` 且未传 `background_color` 时，默认背景色为 `green`（绿色）。以下示例演示如何将人像抠图结果输出为白色背景的 MP4 视频： ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/matte-portrait-video' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "video_url": "https://example.com/your_portrait_video.mp4", "format": "MP4", "background_color": "white" }' ``` ## 参考信息 ### 应用场景 * **虚拟背景与直播**：在视频会议、在线教育或直播中，实时或离线替换人物背景，打造专业、有趣的虚拟场景。 * **影视与短视频创作**：将拍摄的人物或物品素材与任意背景、特效视频进行合成，创造出天马行空的视觉效果。 * **电商视频制作**：为商品动态展示视频更换不同风格的背景，或生成背景透明的素材，方便在各种营销场景中重复使用。 * **教育与演示**：将讲解人抠出并叠加在课件或演示内容之上，制作更具吸引力的画中画式教学视频。 ### 使用限制 |限制项 |说明 | |---|---| |输入文件 |* **视频来源**：支持公网 HTTP/HTTPS URL、本地上传 (`mediakit://`)、来源于火山引擎视频点播 (`vod://`) 和火山引擎对象存储 (`tos://`) 四种输入协议。关于各协议的具体说明和使用示例，请参阅[多源媒体输入与本地上传](https://docs.volcengine.com/docs/6448/2536893)。

* **支持格式**：`mp4`, `flv`, `ts`, `avi`, `mov`, `mkv`, `wmv` 等主流视频格式。

* **文件大小**：建议单个输入文件大小不超过 10 GB。 | ### 处理耗时任务处理时长与视频的原始时长和分辨率相关，通常处理耗时在视频时长的 1~3 倍之间。 ## 相关 API 文档 * [提交视频人像抠图任务 API](https://docs.volcengine.com/docs/6448/2464608) * [提交视频绿幕抠图任务 API](https://docs.volcengine.com/docs/6448/2464612) * [查询任务信息 API](https://docs.volcengine.com/docs/6448/2278532) * [事件回调](https://docs.volcengine.com/docs/6448/2288701)