AI 腹肌濾鏡

概述

AI 腹肌濾鏡 API 可讓您為照片加入逼真的腹部線條，以最少的力氣生成運動感的塑形結果。上傳全身或上半身圖片，選擇想要的增強模式，設定強度等級，即可獲得編輯後的輸出圖片。

支援的模式：

Six-pack：加入可見的六塊肌，呈現更結實的軀幹外觀。
Vest-line：強化腹部中央肌肉線條，呈現健體、運動的外觀。

整合指南

輸入需求與處理標準：

上傳全身或上半身圖片。
選擇增強模式：Six-pack 或 Vest-line。
選擇想要的腹部增強強度等級。
長邊影像解析度上限不得超過 4096 px。
來源檔案大小必須低於 10 MB。
至少需要一位可偵測的人物，且兩側肩膀都可見。
腹部必須可見，穿著或未穿著皆可。
支援的姿勢範圍：−45° < yaw < 45°。
支援單人處理。若圖片中出現多人，API 會自動選擇可見肩膀面積最大的人。

工作流程：

使用 File API 上傳檔案 metadata。
從回應中取得簽名的上傳網址。
將實際圖片上傳到回傳的網址。
建立腹部塑形增強的 AI 任務。
設定 Webhook 或輪詢任務狀態直到完成。
處理成功後下載生成的結果圖片。

步驟 1 — 使用 File API 上傳檔案 metadata

使用 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 API 回應範例：

{
  "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 API 回應細節

回應包含：

欄位	說明
`file_id`	用於建立 AI 任務的識別碼。
`requests.url`	用於上傳實際圖片檔案的簽名網址。
`requests.method`	上傳方法，通常為 `PUT`。
`requests.headers`	上傳請求所需的標頭。

步驟 3 — 上傳圖片到提供的網址

使用 File API 回應中的 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 API 上傳流程回傳的檔案 ID。使用上傳檔案工作流程時為必要。	`"SaGaqpDgKwFrVBgMpQMA3HY0LeqdT9/13W5TOD8/u/FfjK3xgCQ+hRt9MJXBFaud"`
`src_file_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 任務 API 回應：

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

步驟 5 — 設定 W/ook 或輪詢任務結果

設定與驗證細節請參考 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 中包含下載網址。

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

API Key 無效的回應：

若 access token 無效，API 會回傳 401 回應。

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

應用案例：

檔案規格與錯誤

檔案規格：

規格	需求
圖片類型	全身或上半身圖片。
來源主體	一位可偵測的人物，兩側肩膀與腹部都可見。
姿勢需求	支援的姿勢範圍為 `−45° < yaw < 45°`。
多人處理	若偵測到多人，API 會自動選擇可見肩膀面積最大的人。
長邊解析度上限	長邊不得超過 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-strings）；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