# 執行 AI 2D 耳環虛擬試戴任務。

這個端點啟動耳環虛擬試戴流程。您必須提供來源檔案與參考圖片（透過網址或檔案 ID），以及對位、陰影與佩戴位置的特定參數。任務會以非同步方式處理，您可以使用這個回應回傳的 task_id 查詢其狀態。

Endpoint: POST /s2s/v2.0/task/2d-vto/earring
Security: BearerAuthenticationV2

## Security:

  - `BearerAuthenticationV2` (unknown)
    http bearer

## Request fields (application/json):

  - `object_infos` (array)

  - `object_infos.parameter` (object)

  - `object_infos.parameter.earring_need_remove_background` (boolean)
    耳環圖片是否需要移除背景。
    Example: true

  - `object_infos.parameter.earring_anchor_point` (array)
    耳環圖片的錨點，用於對位。 類型：2 個整數的清單 範圍：[x, y]（像素座標） 預設：null（使用引擎預設）
    Example: null

  - `object_infos.parameter.earring_wearing_location` (array)
    照片中應放置耳環的目標位置。 類型：2 個整數的清單 範圍：[x, y]（像素座標） 預設：null（使用引擎預設）
    Example: null

  - `object_infos.parameter.earring_scale` (number)
    以公分控制耳環的大小。 預設：null（使用引擎預設）
    Example: null

  - `object_infos.parameter.earring_is_right_ear` (boolean)
    耳環是否戴在右耳，預設戴在右耳。
    Example: true

  - `object_infos.parameter.earring_occluded_type` (number)
    耳環屬於哪種遮擋類型。0 代表自動偵測，1 代表遮擋類型，2 代表無。
    Enum: "0", "1", "2"

  - `object_infos.parameter.earring_shadow_intensity` (number)
    套用到耳環的陰影強度（較高＝較深的陰影）。
    Example: 0.5

  - `object_infos.parameter.earring_ambient_light_intensity` (number)
    耳環的環境光調整強度。
    Example: 0.5

## 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)
    錯誤代碼：
* InvalidParameters - 請求參數無效
* CreditInsufficiency - 點數不足，無法執行
* BadRequest - 非預期的請求參數
* InvalidStyleGroup - 風格群組 id 無效
* InvalidStyle - 風格 id 無效
    Enum: "InvalidParameters", "CreditInsufficiency", "InvalidStyleGroup", "InvalidStyle", "BadRequest"

## Response 401:

  - `401` (unknown)
    API 金鑰無效或缺失

## Response 401 fields (application/json):

  - `status` (integer)
    回應狀態
    Example: 401

  - `error` (string)
    Example: Invalid API key

## Response 429:

  - `429` (unknown)
    請求過多

## Response 429 fields (application/json):

  - `status` (integer)
    回應狀態
    Example: 429

  - `error` (string)
    Example: Too many requests