AI 腹肌滤镜

概览

AI 腹肌滤镜接口（AI Abs Filter API）让您在照片里加上逼真的腹部线条，几乎不费力气就做出运动感的塑形效果。上传全身照或上半身照，选好增强模式、设定强度，就能拿到编辑好的输出图片。

支持的模式：

Six-pack：加上清晰可见的六块腹肌，躯干看起来更结实有力。
Vest-line：强化腹部中间的肌肉线条，做出精壮的运动感。

接入指南

输入要求与处理条件：

上传全身照或上半身照。
选择增强模式：Six-pack 或 Vest-line。
设定您想要的腹部增强强度档位。
图片长边分辨率不得超过 4096 px。
源文件大小须小于 10 MB。
至少需要一位可检测的人物，且两侧肩膀可见。
腹部必须可见，穿衣、不穿衣都可以。
支持的姿态范围：−45° < yaw < 45°。
支持单人处理。画面中有多人时，接口会自动选取肩部可见面积最大的那位。

流程：

用 File 接口上传文件元数据。
从响应中取得签名的上传 URL。
把实际图片上传到该 URL。
创建腹肌增强的 AI 任务。
配置 Webhook，或轮询任务状态直到完成。
处理成功后下载生成的结果图片。

第 1 步 — 用 File 接口上传文件元数据

用 POST /s2s/v2.0/file 建立文件记录，取得源图的上传信息。

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 接口响应示例：

{
  "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 上传源图。

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`

请求示例：

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 <YOUR_TOKEN_HERE>'
    },
    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 任务接口响应：

{
  "status": 200,
  "data": {
    "task_id": "SaGaqpDgKwFrVBgMpQMA3HY0LeqdT9_13W5TOD8_u_GPi6NqQ3dhlmN-6ntFwhzT"
  }
}

第 5 步 — 配置 Webhook 或轮询任务结果

配置与验证细节见 Webhook 接入指南。

若走轮询，请用返回的 task_id 查看任务状态。

curl --request GET \
  --url https://yce-api-01.makeupar.com/s2s/v2.0/task/abs-shape/<YOUR_TASK_ID> \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'content-type: application/json'

第 6 步 — 取回结果图片

处理成功时，响应会在 data.results.url 中给出下载 URL。

{
  "status": 200,
  "data": {
    "error": null,
    "results": {
      "url": "https://yce-us.s3-accelerate.amazonaws.com/demo/ttl30/...signature..."
    },
    "task_status": "success"
  }
}

API 密钥无效的响应：

访问令牌无效时，接口返回 401 响应。

{
  "status": 401,
  "error": "Unauthorized",
  "error_code": "InvalidAccessToken"
}

应用场景：

文件规格与错误码

文件规格：

规格项	要求
图片类型	全身照或上半身照。
源图人物	一位可检测的人物，两侧肩膀可见、腹部可见。
姿态要求	支持的姿态范围为 `−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

下载 OpenAPI 描述

ai_abs_filter.json

ai_abs_filter.yaml

概述

电子邮件

YouCamOnlineEditor_API@perfectcorp.com

许可证

服务条款

语言

服务器

https://yce-api-01.makeupar.com