# AI 腹肌滤镜 # 概览 AI 腹肌滤镜接口（**AI Abs Filter API**）让您在照片里加上逼真的腹部线条，几乎不费力气就做出运动感的塑形效果。上传全身照或上半身照，选好增强模式、设定强度，就能拿到编辑好的输出图片。 ![](https://plugins-media.makeupar.com/smb/blog/post/2024-09-27/daf70f5e-a350-46a3-8b6c-f63bd60c6cf0.jpg) 支持的模式： - `Six-pack` ：加上清晰可见的六块腹肌，躯干看起来更结实有力。 - `Vest-line` ：强化腹部中间的肌肉线条，做出精壮的运动感。 --- ## 接入指南 **输入要求与处理条件：** - 上传全身照或上半身照。 - 选择增强模式： `Six-pack` 或 `Vest-line` 。 - 设定您想要的腹部增强强度档位。 - 图片长边分辨率不得超过 **4096 px** 。 - 源文件大小须小于 **10 MB** 。 - 至少需要一位可检测的人物，且两侧肩膀可见。 - 腹部必须可见，穿衣、不穿衣都可以。 - 支持的姿态范围： `−45° < yaw < 45°` 。 - 支持单人处理。画面中有多人时，接口会自动选取肩部可见面积最大的那位。 **流程：** 1. 用 File 接口上传文件元数据。 2. 从响应中取得签名的上传 URL。 3. 把实际图片上传到该 URL。 4. 创建腹肌增强的 AI 任务。 5. 配置 Webhook，或轮询任务状态直到完成。 6. 处理成功后下载生成的结果图片。 --- **第 1 步 — 用 File 接口上传文件元数据** 用 `POST /s2s/v2.0/file` 建立文件记录，取得源图的上传信息。 ```bash curl --request POST \ --url https://yce-api-01.makeupar.com/s2s/v2.0/file \ --header 'Authorization: Bearer YOUR_API_KEY' \ --header 'content-type: application/json' \ --data '{ "files": [ { "content_type": "image/jpg", "file_name": "full_body_photo_01_3dbd1b6683.jpg", "file_size": 547541 } ] }' ``` **File 接口响应示例：** ```json { "status": 200, "data": { "files": [ { "content_type": "image/jpg", "file_name": "full_body_photo_01_3dbd1b6683.jpg", "file_id": "SaGaqpDgKwFrVBgMpQMA3HY0LeqdT9/13W5TOD8/u/FfjK3xgCQ+hRt9MJXBFaud", "requests": [ { "method": "PUT", "url": "https://yce-us.s3-accelerate.amazonaws.com/demo/ttl30/...signature...", "headers": { "Content-Length": "547541", "Content-Type": "image/jpg" } } ] } ] } } ``` --- **第 2 步 — 取得 File 接口响应内容** 响应包含： | 字段 | 说明 | | --- | --- | | `file_id` | 用于创建 AI 任务的标识。 | | `requests.url` | 上传实际图片文件的签名 URL。 | | `requests.method` | 上传方式，通常为 `PUT`。 | | `requests.headers` | 上传请求所需的请求头。 | --- **第 3 步 — 把图片上传到提供的 URL** 用 File 接口响应中的 `requests.url` 上传源图。 ```bash curl --location --request PUT 'https://yce-us.s3-accelerate.amazonaws.com/demo/ttl30/...signature...' \ --header 'Content-Type: image/jpg' \ --header 'Content-Length: 547541' \ --data-binary @'./full_body_photo_01_3dbd1b6683.jpg' ``` --- **第 4 步 — 创建 AI 任务** 用 `POST /s2s/v2.0/task/abs-shape` 创建腹部增强任务。 | 参数 | 说明 | 示例 | | --- | --- | --- | | `src_file_id` | File 接口上传流程返回的文件 ID。走上传文件流程时必填。 | `"SaGaqpDgKwFrVBgMpQMA3HY0LeqdT9/13W5TOD8/u/FfjK3xgCQ+hRt9MJXBFaud"` | | `src_file_url` | 源图的直接 URL。可作为 `src_file_id` 的替代方案。 | `"https://example.com/selfie.jpg"` | | `mode` | 增强模式。支持的取值为 `Six-pack` 与 `Vest-line`。 | `"Six-pack"` | | `intensity` | 腹部增强强度档位。 | `1` | **请求示例：** ```javascript const resp = await fetch( 'https://yce-api-01.makeupar.com/s2s/v2.0/task/abs-shape', { method: 'POST', headers: { 'Content-Type': 'application/json', Authorization: 'Bearer ' }, body: JSON.stringify({ src_file_url: 'https://example.com/selfie.jpg', mode: 'Six-pack', intensity: 1 }) } ); const data = await resp.json(); console.log(data); ``` **AI 任务接口响应：** ```json { "status": 200, "data": { "task_id": "SaGaqpDgKwFrVBgMpQMA3HY0LeqdT9_13W5TOD8_u_GPi6NqQ3dhlmN-6ntFwhzT" } } ``` --- **第 5 步 — 配置 Webhook 或轮询任务结果** 配置与验证细节见 [Webhook 接入指南](/develop/webhook)。 若走轮询，请用返回的 `task_id` 查看任务状态。 ```bash curl --request GET \ --url https://yce-api-01.makeupar.com/s2s/v2.0/task/abs-shape/ \ --header 'Authorization: Bearer YOUR_API_KEY' \ --header 'content-type: application/json' ``` --- **第 6 步 — 取回结果图片** 处理成功时，响应会在 `data.results.url` 中给出下载 URL。 ```json { "status": 200, "data": { "error": null, "results": { "url": "https://yce-us.s3-accelerate.amazonaws.com/demo/ttl30/...signature..." }, "task_status": "success" } } ``` **API 密钥无效的响应：** 访问令牌无效时，接口返回 `401` 响应。 ```json { "status": 401, "error": "Unauthorized", "error_code": "InvalidAccessToken" } ``` 应用场景： ![](https://plugins-media.makeupar.com/smb/blog/post/2025-08-21/307f87b4-d31c-481c-86f1-478c93265a95.jpg) ![](https://plugins-media.makeupar.com/smb/blog/post/2025-08-21/8ab8eca4-b825-4692-aef0-6ffd6176e272.jpg) --- ## 文件规格与错误码 **文件规格：** | 规格项 | 要求 | | --- | --- | | 图片类型 | 全身照或上半身照。 | | 源图人物 | 一位可检测的人物，两侧肩膀可见、腹部可见。 | | 姿态要求 | 支持的姿态范围为 `−45° < yaw < 45°`。 | | 多人处理 | 检测到多人时，接口会自动选取肩部可见面积最大的那位。 | | 长边分辨率上限 | 长边不得超过 **4096 px**。 | | 文件大小上限 | 须小于 **10 MB**。 | | 支持格式 | `jpg`、`png`。 | **错误码：** | 错误码 | 说明 | | --- | --- | | `exceed_max_filesize` | 源图超出允许的尺寸或文件大小上限。长边不得超过 4096 px，文件大小须保持在 10 MB 以下。 | | `error_pose` | 姿态检测失败：可能是未检测到人、肩部可见度问题、腹部可见度问题、腰部区域检测失败、髋部关键点检测失败，或姿态范围不受支持。 | | `error_nsfw_content_detected` | 在源图或生成的结果图中检测到疑似不适宜内容（NSFW）。 | | `invalid_parameter` | 源键、目标键、动作、模式取值、强度档位或任务配置中提供了无效参数。 | | `error_download_image` | 源图片下载失败。 | | `error_decode_image` | 源图片解码失败。 | **运行环境与依赖：** | 工具 / 语言 | 建议运行时版本 | | --- | --- | | cURL | Bash ≥ 3.2；curl ≥ 7.58（支持现代 TLS/HTTP）；jq ≥ 1.6（稳健的 JSON 解析）。 | | Node.js | Node ≥ 18，以支持全局 `fetch`。 | | JavaScript 浏览器支持 | Chrome / Edge ≥ 80、Firefox ≥ 74、Safari ≥ 13.1。 | | PHP | PHP ≥ 7.4（兼容现代 TLS）；建议 ext-curl，或 `allow_url_fopen=On` 并具备 OpenSSL 与 JSON 支持。 | | Python | Python ≥ 3.10（支持 f-string）；requests ≥ 2.20.0。 | | Java | Java 11+（HttpClient）；Jackson Databind ≥ 2.12.0。 | --- ## 点数消耗 | AI 功能 | 消耗点数 | | --- | --- | | AI 腹肌滤镜 V1.0 | 1 | --- License: Privacy policy ## Servers ``` https://yce-api-01.makeupar.com ``` ## Security ### BearerAuthenticationV2 使用标准的 Bearer 鉴权。把您的 API 密钥放进请求头： `Authorization:Bearer YOUR_API_KEY`。请注意 'Bearer' 与 'YOUR_API_KEY' 之间有一个空格。 Type: http Scheme: bearer ## Download OpenAPI description - [AI 腹肌滤镜](https://docs.perfectcorp.com/_bundle/@l10n/zh-CN/reference/ai_abs_filter.yaml) ## V1.0 - [POST /s2s/v2.0/task/abs-shape](https://docs.perfectcorp.com/zh-cn/reference/ai_abs_filter/v1.0/paths/~1s2s~1v2.0~1task~1abs-shape/post.md): AI 任务是异步处理的。功能支持 Webhook 时，优先用 Webhook 来接收完成通知。配置好您的 Webhook 端点、校验 Webhook 签名，收到 `success` 或 `error` 通知后，用收到的 `task_id` 查询任务结果。配置与校验的细节请见 [Webhook 接入指南](/develop/webhook)。 若功能不支持 Webhook，或您的接入方式用不了 We - [GET /s2s/v2.0/task/abs-shape/{task_id}](https://docs.perfectcorp.com/zh-cn/reference/ai_abs_filter/v1.0/paths/~1s2s~1v2.0~1task~1abs-shape~1%7Btask_id%7D/get.md)