コンテンツへスキップ
体型補正/
/
ファイル仕様とエラー

体型補正

概要

体型補正 API による体型補正＆スリミング AI 体型補正 API で、写真のスリミングと体型補正を行います。

統合ガイド

このガイドでは、AI 体型補正 API のワークフローについて説明します。

エンドポイント: /s2s/v2.0/task/body-reshape

認証必須: Authorization: Bearer YOUR_API_KEY

ワークフロー手順:

  1. 画像アップロードの準備:

    • アップロード用のセルフィー画像を準備します。
    • ファイル API /s2s/v2.0/file を呼び出し、アップロード URL と関連する file_id を取得します。
    • 提供されたアップロード URL を使用してセルフィー画像をアップロードします。

  2. グループ写真の場合のオプション前処理:

    • 画像内に複数の人物がいる場合は、セルフィー画像を前処理します。

  3. 体型補正効果の設定:

    • まず、適切な体型補正パラメータを選択します。

  4. AI タスクの開始とタスク ID の取得:

    • file_id と選択した効果設定を HTTP POST リクエストで /s2s/v2.0/task/body-reshape に送信します。
    • この操作を識別するための一意なタスク ID をレスポンスで待ちます。

  5. タスクステータスのポーリング（継続的な確認）:

    • 取得した task_id を使用し、HTTP GET リクエスト（例: GET /s2s/v2.0/task/body-reshape/${task_id}）で定期的にタスクステータスをポーリングします。
    • 以下を継続的に監視します。
    • Task_status = "success"（処理完了）。
    • Task_status = "error"（該当する場合、解決または再試行）。
    • ステータスが success に遷移したら、ワークフローを適切に更新します。
  • API プレイグラウンド

API プレイグラウンドで API を対話的にテストします。

API プレイグラウンド: http://yce.makeupar.com/api-console/en/api-playground/ai-body-reshape/

  • 認証
  • リクエストヘッダーに Bearer トークン を使用して API キーを含めます。
Authorization: Bearer YOUR_API_KEY

API キーの確認場所: https://yce.makeupar.com/api-console/en/api-keys/.

    1. 画像のアップロード

ファイルをサーバーに直接アップロードするか、AI タスクペイロードに有効な画像 URL を指定します。

  • アップロードエンドポイント
POST /s2s/v2.0/file

すでに公開画像 URL がある場合は、この手順をスキップできます。

    1. 効果テンプレートの準備

  • 前処理 ピクセル座標で検出されたバウンディングボックスを出力します。後で体型補正 AI タスクを作成するために、結果のインデックスを使用します。

{
"timed": number,
"result": [
{
 "left": number,
 "top": number,
 "width": number,
 "height": number
}
]
}
  • 効果テンプレート JSON スキーマ
{
"version": "1.0",
"index": 0,
"features": {
"arm": 0, // -100~100
"breast_left": 0, // -100~100
"breast_right": 0, // -100~100
"hip": 0, // -100~100
"hip_lift": 0, // -100~100
"leg": 0, // -100~100
"neck_left": 0, // 0~100
"neck_right": 0, // 0~100
"shoulder_left": 0, // -100~100
"shoulder_right": 0, // -100~100
"squared_shoulder_left": 0, // -100~100
"squared_shoulder_right": 0, // -100~100
"slim": 0, // -100~100
"taller": 0, // 0~100
"waist": 0, // -100~100
"belly": 0 // -100~100
}
}

index: 前処理で検出された体のインデックス。省略可、初期値 0。 features: 少なくとも 1 つの非ゼロの体型補正パラメータが必須です。すべてゼロにはできません。

  • ペイロードの例（送信可能）
{
 "src_file_url": "https://plugins-media.makeupar.com/strapi/assets/body_reshape_02_7777218379.jpg",
 "version": "1.0",
 "index": 0,
 "features": {
"arm": 0,
"waist": -20,
"taller": 80,
"squared_shoulder_left": 10,
"squared_shoulder_right": 10,
"neck_left": 0,
"neck_right": 0,
"hip": 10,
"breast_left": 30,
"breast_right": 30,
"slim": -70,
"shoulder_left": 30,
"shoulder_right": 30,
"leg": -30,
"hip_lift": 0,
"belly": -50
 }
}
    1. 体型補正 AI タスクの作成と結果のポーリング

画像と完全な効果ペイロードが準備できたら、タスクを作成します。API はリクエストを非同期で処理します。ステータスが success または error になるまで、タスクステータスをポーリングする必要があります。

  • タスク作成エンドポイント
POST /s2s/v2.0/task/body-reshape
  • ポーリングエンドポイント
GET /s2s/v2.0/task/body-reshape/{task_id}

ファイル仕様とエラー

  • AI 体型補正仕様

対応セルフィービュー 顔の表情と体の姿勢がはっきりと見える全身写真。

可視性とポーズの要件

領域ソース画像で満たすべき条件
首ソース画像内で首が見えている必要があります。
腕両腕（上腕、前腕、手）が完全に写っている必要があります。
脚脚全体が画像内に写っている必要があります。
ヒップヒップが視界に入っている必要があります。
ヒップリフトヒップが視界に入っている必要があります。
肩• 肩が見えている必要があります。
• 手を上げるポーズは許可されていません。
• 90° の横向きポーズは許可されていません。
腹部腹部が見えている必要があります。
ウエストウエストが見えている必要があります。
胸• 胸の領域が画像内に写っている必要があります。
• ヒップを含むショットである必要があります（「ヒップなしのハーフボディ」は不可）。
• 胸の中央が見えている必要があります。
スリム肩がフレーム内に入っている必要があります。
身長• ヒップが写っている必要があります。
• ハーフボディビューの場合、脚が含まれている必要があります（脚が見えていること）。

体型補正カスタマイズパラメータガイド

カテゴリパラメータ機能最小値 (-100 / 0)最大値 (100)
腕強度腕の太さを調整します細い太い
腹部強度腹部の突出を調整します平坦突出
胸強度（左 / 右）各側の胸のボリュームを調整します平坦豊か
ヒップリフト強度ヒップの曲率とリフトを調整します（ヒップアップ効果を追加）引き締まった（リフトアップ＆引き締め）丸みのある（リフトアップ＆ボリュームアップ）
ヒップサイズ強度ヒップ全体の幅を調整します狭い広い
脚強度脚の太さを調整します細い太い
首強度（左 / 右）各側の首の輪郭とスリミングを調整します元通り (0)引き締まった
肩幅強度（左 / 右）各肩の幅を調整します狭い広い
肩の形強度（左 / 右）各肩の角度と傾きを調整します傾斜四角い
スリム強度全身の曲線を調整しますスリム曲線的
身長強度人物全体の身長を調整します元通り (0)高い
ウエスト強度ウエストラインの幅を調整します狭い広い

注意: “左”と“右”は、視聴者の画面の左右ではなく、人物本人の視点に基づいています。

  • 対応フォーマットと寸法
AI 機能対応寸法対応ファイルサイズ対応フォーマット
AI 体型補正長辺 <= 2048、短辺 >= 320< 10MBjpg/jpeg/png
  • エラーコード
エラーコード説明
RUNTIME_ERROR体型補正の実行中に予期しないエラーが発生しました
PHOTO_DETECTION_FAILユーザー写真を正しく処理できませんでした。例えば、手が検出されませんでした
PHOTO_CHECK_INVALIDユーザー写真のポーズまたはサイズが無効です
INPUT_ERROR入力ファイルフォーマットが正しくありません
INPUT_MAIN_IMAGE_EMPTYユーザー画像が必要です
  • 環境と依存関係
サンプルコード言語 / ツール推奨ランタイムバージョン
cURL- bash >= 3.2
- curl >= 7.58 (モダンな TLS/HTTP サポート)
- jq >= 1.6 (堅牢な JSON パーシング)
Node.js (JavaScript)Node >= 18 (グローバル fetch のため)
JavaScript- Chrome / Edge >= 80
- Firefox >= 74
- Safari >= 13.1
PHPPHP >= 7.4 (モダンな TLS/互換性のため), ext-curl (推奨) または allow_url_fopen=On + ext-openssl, ext-json
PythonPython >= 3.10 (f-strings のため), requests >= 2.20.0
JavaJava 11+ (HttpClient のため), Jackson Databind >= 2.12.0

ユニット消費

AI 機能消費ユニット
AI 体型補正 V1.01
OpenAPI記述をダウンロード
ai_body_reshape.json
ai_body_reshape.yaml
概要
メール
YouCamOnlineEditor_API@perfectcorp.com
ライセンス
Privacy policy
利用規約
言語
サーバー
https://yce-api-01.makeupar.com