# バーチャルメイクタスクを実行します。

このエンドポイントは、バーチャルメイク処理を開始します。ソースファイル（URL または File ID 経由）を提供し、定義されたエフェクトスキーマを使用して適用するエフェクトを指定する必要があります。タスクは非同期で処理され、このレスポンスで返される task_id を使用してステータスを確認できます。

Endpoint: POST /s2s/v2.0/task/makeup-vto
Security: BearerAuthenticationV2

## Security:

  - `BearerAuthenticationV2` (unknown)
    http bearer

## Request fields (application/json):

  - `version` (string)
    メイクエフェクト仕様のバージョン。特に指定がない限り、初期値は `"1.0"` です。
    Example: 1.0

  - `effects` (array, required)
    適用するメイクエフェクトの配列。各エフェクトオブジェクトは `category` を指定し、そのメイクタイプのスキーマに一致する必要があります。

  - `effects.category` (string, required)
    このエフェクトが肌スムージングエフェクトであることを識別します。常に "skin_smooth" である必要があります。
    Enum: "skin_smooth"

  - `effects.skinSmoothStrength` (integer)
    全体の肌テクスチャに適用されるスムージングの強度。値が高いほど、より柔らかくエアブラシをかけたような肌の外観になります。

  - `effects.skinSmoothColorIntensity` (integer)
    スムージング処理中に適用される色のブレンド強度です。肌トーンの統一と色の不均一性の低減に役立ちます。

  - `effects.category` (string, required)
    このエフェクトがチークエフェクトであることを識別します。常に "blush" である必要があります。
    Enum: "blush"

  - `effects.pattern` (object, required)
    顔へのチークの配置方法を定義します。各パターンは、blush.json 内の顔の形状とレイアウトに対応しています。

  - `effects.pattern.name` (string, required)
    チークパターンの名前です。blush.json パターンカタログの `label` と一致する必要があります。
    Example: 1color1

  - `effects.palettes` (array, required)
    カラーパレットエントリのリストです。必要なパレットの数は、選択したチークパターンで定義されている `colorNum` フィールドに依存します。

  - `effects.palettes.color` (string, required)
    16 進数形式（#RRGGBB）のメインチークカラーです。チーク適用時の主要な顔料として使用されます。

  - `effects.palettes.texture` (string, required)
    チークの質感：
- matte：純粋な顔料、光沢なし
- satin：ソフトな輝き、glowStrength が必要
- shimmer：キラキラまたは輝き、shimmer パラメータが必要
    Enum: "matte", "satin", "shimmer"

  - `effects.palettes.glowStrength` (integer)
    サテンチーク質感の輝き強度です。texture = "satin" または "shimmer" の場合に必須です。

  - `effects.palettes.shimmerColor` (string)
    シマー粒子の色です。texture = "shimmer" の場合に必須です。

  - `effects.palettes.shimmerDensity` (integer)
    チーク適用時のシマー粒子の密度です。texture = "shimmer" の場合に必須です。

  - `effects.palettes.colorIntensity` (integer, required)
    ベース顔料に対するチークカラーの強度です。

  - `effects.category` (string, required)
    このエフェクトがブロンザーエフェクトであることを識別します。常に "bronzer" である必要があります。
    Enum: "bronzer"

  - `effects.pattern` (object, required)
    ブロンザーの適用レイアウトを定義します。パターン名は bronzer.json の `label` と一致する必要があります。

  - `effects.pattern.name` (string, required)
    bronzer.json カタログからのブロンザーパターンの名前です。
    Example: Bronzer1

  - `effects.palettes` (array, required)
    ブロンザーパレットには、顔料の色と強度のコントロールが含まれます。

  - `effects.palettes.color` (string, required)
    16 進数形式（#RRGGBB）のブロンザーカラーです。

  - `effects.palettes.colorIntensity` (integer, required)
    ブロンザー顔料の強度です。

  - `effects.category` (string, required)
    このエフェクトがコンシーラーエフェクトであることを識別します。常に "concealer" である必要があります。
    Enum: "concealer"

  - `effects.palettes` (array, required)
    色と強度の特性を定義する 1 つ以上のコンシーラーパレットです。同じパレットが、目の下、額、あごの補正ゾーンなど、関連する顔面領域に適用されます。

  - `effects.palettes.color` (string, required)
    16 進数 RGB 形式（#RRGGBB）のコンシーラーシェードです。通常、肌トーンと一致するか、わずかに明るくする必要があります。

  - `effects.palettes.colorIntensity` (integer, required)
    顔全体に適用される一般的なコンシーラー顔料の強度です。

  - `effects.palettes.colorUnderEyeIntensity` (integer, required)
    目の下領域に特化した顔料強度のコントロールです。他のゾーンへの過剰な適用なく、クマを明るくするのに役立ちます。

  - `effects.palettes.coverageLevel` (integer, required)
    コンシーラーのカバレッジの不透明度を決定します。値が高いほど、色ムラや肌トラブルをより多く隠します。

  - `effects.category` (string, required)
    このエフェクトがコントゥアエフェクトであることを識別します。常に "contour" である必要があります。
    Enum: "contour"

  - `effects.pattern` (object, required)
    顔へのコントゥアシャドウの適用場所を定義します。contour.json で定義されているパターン名（例：HeartFace2, OvalFace6）を使用する必要があります。

  - `effects.pattern.name` (string, required)
    コントゥアパターンの名前です。contour.json の `label` と一致する必要があります。
    Example: OvalFace6

  - `effects.palettes` (array, required)
    コントゥアリングに使用される顔料を定義します。通常、ファンデーションよりも暗いクールトーンまたはニュートラルシェードです。

  - `effects.palettes.color` (string, required)
    16 進数形式（#RRGGBB）のコントゥア顔料カラーです。

  - `effects.palettes.colorIntensity` (integer, required)
    コントゥア顔料の強度です。値が高いほど、深いシャドウになります。

  - `effects.category` (string, required)
    このエフェクトが眉毛スタイリングエフェクトであることを識別します。常に "eyebrows" である必要があります。
    Enum: "eyebrows"

  - `effects.pattern` (object, required)
    この設定は、眉毛パターンモードを定義し、形状の調整または色のみの適用のいずれかを行います。必要に応じて、パターン名は eyebrows.json のラベルと一致する必要があります。

  - `effects.pattern.type` (string)
    カスタマイズされた眉毛パターン形状を使用
    Enum: "shape"

  - `effects.pattern.name` (string, required)
    眉毛形状パターンの名前です。eyebrows.json の `label` と一致する必要があります。
    Example: SoftArch1

  - `effects.pattern.curvature` (integer)
    眉の曲がりを調整します。負の値 = より平ら/真っ直ぐ、正の値 = より曲がります。

  - `effects.pattern.thickness` (integer)
    検出された眉に対する眉の太さの調整を制御します。正の値 = より太く、負の値 = より細くなります。

  - `effects.pattern.definition` (integer)
    眉のシャープさと明瞭さ。値を高くすると、よりクリーンな見た目にするために眉のエッジの輪郭が強調されます。

  - `effects.pattern.type` (string)
    ユーザーの元の眉の形状を使用します
    Enum: "color"

  - `effects.palettes` (array, required)
    眉の色パレット。各パレットは、ピグメントとオプションのシマー効果（シマーテクスチャのみ）を制御します。

  - `effects.palettes.color` (string, required)
    #RRGGBB 形式の眉ピグメントカラー。

  - `effects.palettes.colorIntensity` (integer, required)
    眉の色を適用する際に使用されるピグメント強度。

  - `effects.palettes.texture` (string, required)
    眉ピグメントのテクスチャスタイル。シマーは眉の毛に反射ハイライトを追加します。
    Enum: "matte", "shimmer"

  - `effects.palettes.shimmerColor` (string)
    texture = shimmer の場合に適用されるシマーカラー。

  - `effects.palettes.shimmerIntensity` (integer)
    シマーの輝きの強さ。texture = shimmer の場合のみ必須です。

  - `effects.palettes.shimmerSize` (integer)
    シマーパーティクルのサイズ。シマーテクスチャの場合に必須です。

  - `effects.palettes.shimmerDensity` (integer)
    眉内のシマーパーティクルの密度。シマーテクスチャの場合に必須です。

  - `effects.category` (string, required)
    この効果をアイライナー効果として識別します。常に "eye_liner" である必要があります。
    Enum: "eye_liner"

  - `effects.pattern` (object, required)
    アイライナーの形状と配置を定義します。パターン名は eyeliner.json のラベルと一致する必要があります。

  - `effects.pattern.name` (string, required)
    アイライナーパターンの名前。eyeliner.json のラベルと等しい必要があります。
    Example: Arabic3

  - `effects.palettes` (array, required)
    アイライナーカラーパレットエントリ。各パレットは、ピグメントカラー、シマー/メタリック効果、全体的な強度を制御します。選択したアイライナーパターンが複数の色を必要とする場合、より多くのパレットが使用されます。

  - `effects.palettes.color` (string, required)
    #RRGGBB 形式のアイライナーピグメントカラー。

  - `effects.palettes.texture` (string, required)
    アイライナーのテクスチャ仕上げは、フラットで不透明な効果のマット、輝く反射仕上げのシマー（シマーフィールド付き）、または光沢のあるメタリック光沢のメタリック（シマーフィールドとメタリック強度が必要）など、ライナーの外観を指定します。
    Enum: "matte", "shimmer", "metallic"

  - `effects.palettes.shimmerColor` (string)
    シマーまたはメタリック反射パーティクルに使用される色。texture が shimmer または metallic の場合に必須です。

  - `effects.palettes.shimmerIntensity` (integer)
    反射スパークルの強さ。texture が shimmer または metallic の場合に必須です。

  - `effects.palettes.metallicIntensity` (integer)
    メタリック反射レベル。texture = metallic の場合に必須です。

  - `effects.palettes.colorIntensity` (integer, required)
    アイライナーカラーのピグメント強度。

  - `effects.category` (string, required)
    この効果をアイシャドウ効果として識別します。常に "eye_shadow" である必要があります。
    Enum: "eye_shadow"

  - `effects.pattern` (object, required)
    アイシャドウの配置パターンを定義します。eyeshadow.json の `label`（例：1color1、2colors1 など）と一致する必要があります。

  - `effects.pattern.name` (string, required)
    eyeshadow.json のパターン名。色数とシャドウ配置ゾーンを決定します。
    Example: 2colors1

  - `effects.palettes` (array, required)
    1つ以上のピグメントパレットエントリ。必要なパレット数は、パターンの `colorNum` に依存します。各パレットは、アイシャドウパターン内の特定のレイヤー/色を定義します。

  - `effects.palettes.color` (string, required)
    HEX 形式（#RRGGBB）のアイシャドウピグメントカラー。

  - `effects.palettes.texture` (string, required)
    アイシャドウの表面外観は、滑らかでフラットな見た目のマット、輝く効果のシマー（シマーパラメータが必要）、または大胆なメタリック光沢のメタリック（シマーパラメータとメタリック強度が必要）などの仕上げを決定します。
    Enum: "matte", "shimmer", "metallic"

  - `effects.palettes.shimmerColor` (string)
    シマーパーティクルの色。texture = shimmer または metallic の場合に必須です。

  - `effects.palettes.shimmerIntensity` (integer)
    シマーまたはメタリックテクスチャの反射スパークルの強さ。

  - `effects.palettes.metallicIntensity` (integer)
    メタリック反射レベル。メタリックテクスチャの場合に必須です。

  - `effects.palettes.colorIntensity` (integer, required)
    各シャドウカラーの全体的なピグメントレベル。

  - `effects.category` (string, required)
    この効果をまつ毛効果として識別します。常に "eyelashes" である必要があります。
    Enum: "eyelashes"

  - `effects.pattern` (object, required)
    適用されるまつ毛スタイル（ナチュラル、アーティスティック、ウィング、上/下など）を定義します。eyelashes.json の `label` と一致する必要があります。

  - `effects.pattern.name` (string, required)
    eyelashes.json のまつ毛パターンの名前。
    Example: Upper1

  - `effects.palettes` (array, required)
    まつげの色パレット。まつげはシマー/メタリック効果には対応していません。色と強度のみをサポートします。

  - `effects.palettes.color` (string, required)
    HEX 形式（#RRGGBB）のまつげの色。

  - `effects.palettes.colorIntensity` (integer, required)
    まつげに適用される暗さ/色素の強さ。

  - `effects.category` (string, required)
    この効果をファンデーション効果として識別します。常に "foundation" である必要があります。
    Enum: "foundation"

  - `effects.palettes` (array, required)
    トーン、カバー力、輝き、色の強度を制御するファンデーションパレットのエントリ。

  - `effects.palettes.color` (string, required)
    #RRGGBB 形式のファンデーションシェード。通常、自然な肌色に近い色です。

  - `effects.palettes.colorIntensity` (integer, required)
    ファンデーション着色の強度。

  - `effects.palettes.glowIntensity` (integer, required)
    肌の仕上げに輝きを加えます。値が高いほど、輝くまたは濡れたような効果が生まれます。

  - `effects.palettes.coverageIntensity` (integer, required)
    ファンデーションカバーの不透明度を制御します。値が高いほど、より多くの欠点を隠します。

  - `effects.category` (string, required)
    この効果をハイライター効果として識別します。常に "highlighter" である必要があります。
    Enum: "highlighter"

  - `effects.pattern` (object, required)
    ハイライト配置パターン。highlighter.json の `label` と一致する必要があります（例：HeartFace4, Oblong11, OvalFace2）。

  - `effects.pattern.name` (string, required)
    highlighter.json カタログからのハイライトパターンの名前。
    Example: SquareFace3

  - `effects.palettes` (array, required)
    シマー、輝き、密度、色を定義するハイライターパレットのエントリ。

  - `effects.palettes.color` (string, required)
    #RRGGBB HEX 形式のハイライター色素の色。通常、白、シャンパン、ゴールド、ピンク系のトーンです。

  - `effects.palettes.glowIntensity` (integer, required)
    肌に追加される非シマーの輝きの量。値が高いほど、より輝く、放射状の仕上げになります。

  - `effects.palettes.shimmerIntensity` (integer, required)
    シマー反射の強さ。値が高いほど、よりキラキラします。

  - `effects.palettes.shimmerDensity` (integer, required)
    面積あたりのシマー粒子の数。密度が高いほど、よりグリッターのような効果が生まれます。

  - `effects.palettes.shimmerSize` (integer, required)
    シマー粒子のサイズ。粒子が大きいほどグリッターのような効果が生まれ、小さいほど細かいシマーになります。

  - `effects.palettes.colorIntensity` (integer, required)
    ハイライター色素の強さ。

  - `effects.category` (string, required)
    この効果をリップスティック/リップカラー効果として識別します。常に "lip_color" である必要があります。
    Enum: "lip_color"

  - `effects.shape` (object, required)
    唇の境界と形状変更を定義します。パターン名は lipshape.json と一致する必要があります（例：plump, original, pouty）。

  - `effects.shape.name` (string, required)
    唇の縁とシルエットを変更するために使用されるリップシェイプスタイル。lipshape.json の `label` と等しくなければなりません。
    Example: plump

  - `effects.morphology` (object)
    唇へのオプションの形態調整。ふっくら感を高め、唇のしわを減らします。

  - `effects.morphology.fullness` (integer)
    唇がどれだけふっくら見えるかを制御します。値が高いほど、より大きく、ボリュームのある唇になります。

  - `effects.morphology.wrinkless` (integer)
    唇のしわと質感を滑らかにします。値が高いほど、より滑らかな唇の外観になります。

  - `effects.palettes` (array, required)
    色素、質感、シマー、グロスを制御するリップカラーパレットのエントリ。オンブレまたはツートーンスタイルのために複数のパレットを使用できます。

  - `effects.palettes.color` (string, required)
    HEX 形式（#RRGGBB）のリップスティックの色。

  - `effects.palettes.texture` (string, required)
    この設定はリップ仕上げの質感を示します。グロスを選択した場合は、グロスプロパティを含めてください。シマー、メタリック、ホログラフィック仕上げの場合は、シマー関連のフィールドを追加してください。シアー、シマー、グロスの場合は、透明度強度を含めることを忘れないでください。
    Enum: "matte", "gloss", "holographic", "metallic", "satin", "sheer", "shimmer"

  - `effects.palettes.colorIntensity` (integer, required)
    リップスティック色素の強度。

  - `effects.palettes.gloss` (integer)
    グロス/ホログラフィック/メタリック/シアー/シマー質感の光沢レベル。

  - `effects.palettes.shimmerColor` (string)
    シマー、メタリック、ホログラフィック質感のシマー粒子の色。

  - `effects.palettes.shimmerIntensity` (integer)
    シマー反射の強さ。

  - `effects.palettes.shimmerDensity` (integer)
    シマー粒子の密度。

  - `effects.palettes.shimmerSize` (integer)
    シマー粒子のサイズ。

  - `effects.palettes.transparencyIntensity` (integer)
    透明度効果の強さ。シアー、シマー、グロスの質感に使用されます。

  - `effects.style` (object, required)
    スタイルは、均一なシェード、トーンをブレンドするオンブレグラデーション、唇の異なる部分にコントラストのある色を使ったツートーン効果など、リップカラーのアートルックを記述します。

  - `effects.style.type` (string, required)
    リップカラーのスタイル。
    Enum: "full", "ombre", "twoTone"

  - `effects.style.innerColorRatio` (integer)
    セカンダリーカラーが内側にどこまで広がるかを決定します（オンブレのみ）。type = ombre の場合は必須です。

  - `effects.style.blendStrength` (integer)
    色間のブレンドの柔らかさ。type = ombre の場合は必須です。

  - `effects.category` (string, required)
    このエフェクトがリップライナーエフェクトであることを識別します。常に "lip_liner" である必要があります。
    Enum: "lip_liner"

  - `effects.pattern` (object, required)
    lipliner.json のパターンに基づいてリップライナーの配置を定義します。

  - `effects.pattern.name` (string, required)
    リップライナーパターンの名前（例：Natural1, LargerUpper1）。
    Example: Natural1

  - `effects.palettes` (array, required)
    色、太さ、滑らかさを定義するリップライナーパレットエントリ。

  - `effects.palettes.color` (string, required)
    HEX 形式のリップライナーピグメントカラー。

  - `effects.palettes.texture` (string, required)
    リップライナーの仕上げタイプ。
    Enum: "matte", "satin"

  - `effects.palettes.colorIntensity` (integer, required)
    リップライナーの発色強度。

  - `effects.palettes.thickness` (integer, required)
    リップライナーストロークの太さ — 値が大きいほど輪郭が太くなります。

  - `effects.palettes.smoothness` (integer, required)
    ストロークエッジの滑らかさ。値が大きいほど、柔らかくブレンドされたラインになります。

  - `src_file_url` (string, required)
    タスクを実行するファイルの URL。この URL は公開アクセス可能である必要があります。
    Example: https://example.com/selfie.jpg

  - `src_file_id` (string, required)
    タスクを実行するファイルの ID。ファイルアップロード API からの File ID です。
    Example: pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE=

## Response 200:

  - `200` (unknown)
    タスクの実行が成功しました

## Response 200 fields (application/json):

  - `status` (integer)
    レスポンスステータス
    Example: 200

  - `data` (object)

  - `data.task_id` (string)
    このタスクの ID。タスク結果はこの ID で 24 時間有効です。
    Example: grH0CvsgXuAIHLUzD0V1Ol34hoet3R1tvdbtiVHrDb6_UqCLKIejAIajwxrhOAfe

## Response 400:

  - `400` (unknown)
    タスクの実行が失敗しました

## Response 400 fields (application/json):

  - `status` (integer)
    レスポンスステータス
    Example: 400

  - `error` (string)
    エラーメッセージ
    Example: The operation could not be completed

  - `error_code` (string)
    Enum: "CreditInsufficiency", "InvalidStyleGroup", "InvalidStyle", "BadRequest", "InvalidParameters"

## Response 401:

  - `401` (unknown)
    無効な API キー、非アクティブな API キー、または期限切れの API キー

## Response 401 fields (application/json):

  - `status` (integer)
    レスポンスステータス
    Example: 401

  - `error_code` (string)
    Enum: "InvalidApiKey", "InactiveApiKey", "ExpiredApiKey"

## Response 429:

  - `429` (unknown)
    一定時間内にリクエストが多すぎます