AI 豐胸模擬

整合指南

本指南將引導您完成：

AI 豐胸模擬 API 的工作流程：

端點： /s2s/v2.0/task/breast-shape

需要認證： Authorization: Bearer YOUR_API_KEY

工作流程步驟：

1. 圖片上傳準備：

   • 流程從準備胸部自拍開始。

2. AI 豐胸模擬設定 對於 AI 豐胸模擬，透過調整強度等級來控制增強程度，範圍從 1（細微）到 3（明顯）。從較低的設定開始，逐步提高，以達成符合您審美偏好的自然結果。逐步調整有助於確保真實且比例協調的結果。

3. 啟動 AI 任務並取得任務 ID：

   • 透過 HTTP POST 請求，將上傳的圖片與參數設定傳送到 /s2s/v2.0/file。
   • 在回應中取得唯一的任務 ID，用以識別這次互動。

4. 輪詢任務狀態（持續檢查）：

   • 使用取得的 task_id，透過 HTTP GET 請求（例如 GET /task/${task_id}）定期輪詢任務狀態。
   • 持續監控：
     • Task_status = "success"（流程完成）。
     • Task_status = "error"（視情況解決或重試）。
   • 狀態轉為成功後，相應更新工作流程。

這個結構化的工作流程確保與使用者輸入的高效整合、任務的自動化監控，以及無縫取得結果。

• 認證

• 使用 Bearer Token 將您的 API key 納入請求標頭：
  Authorization: Bearer YOUR_API_KEY

您可以在 https://yce.makeupar.com/api-console/en/api-keys/ 找到您的 API Key。

• 上傳圖片

您可以直接上傳檔案到伺服器，或在 AI 任務內容中提供有效的圖片網址。

• 上傳端點

或者，若您已有公開的圖片網址，可跳過此步驟。

• 調整 AI 豐胸模擬強度 AI 豐胸模擬設定

對於 AI 豐胸模擬，透過將強度等級設在 1 到 3 之間來控制修改程度：

• 等級 1 提供細微、自然的外觀調整，最適合輕微精修。
• 等級 2 提供適度增強，在真實感與明顯改善之間取得平衡。
• 等級 3 帶來最明顯的效果，適合顯著重塑，同時維持解剖學的合理性。

選擇最符合您審美目標與理想外觀的強度等級。

• 建立 AI 豐胸模擬任務並輪詢結果

上傳圖片並選擇您偏好的強度等級後，即可開始增強任務。API 以非同步方式處理請求。您必須輪詢任務狀態，直到達到 success 或 error。

• 建立任務端點

• 輪詢端點

檔案規格與錯誤

• AI 豐胸模擬規範 圖片需求與最佳結果建議

• 解析度指引： 輸入圖片的最長邊不得超過 4096 像素。為獲得最佳效能，請確保上半身區域——定義為從頭頂到包含胸部在內的區域——以至少 1024 × 768 像素的解析度呈現。

• 主體需求：

  • 圖片必須包含至少一位可完整偵測的人物。兩側肩膀都應在畫面中清晰可見。
  • 胸部區域必須可見。這包括穿著與未穿著的情況，只要主體主要面向前方（即 yaw 角度介於 −90° 與 +90° 之間）。強烈建議使用正面視角，而非斜向或側面姿勢。

• 提升效果的建議做法：

  • 優先採用上半身構圖：圖片應專注於上半身，或若包含完整身形，上半身區域應佔畫面相當大的比例，其最長維度超過 1024 像素。
  • 僅使用正面姿勢；避免側面或大幅旋轉的位置，因為這些會降低偵測準確度與結果品質。
  • 為了讓胸部輪廓獲得最自然的增強，請選擇在胸部周圍露出部分皮膚的服裝——例如泳裝、低領上衣或 V 領服飾。這些風格讓 AI 更能推斷底層結構，並產生細緻、逼真的效果。
  • 系統僅支援單人主體的圖片。若畫面中出現多人，處理程序會自動針對可見肩膀跨度最大的人（即最接近鏡頭或最居中對齊鏡頭的人）。
  • 避免胸部區域的遮擋。包包、背包帶、圍巾、項鍊或其他配件可能被錯誤移除，或在編輯時產生偽影。
  • 服裝外觀可能與原始圖片不同。修改程度取決於強度設定：較高的增強等級會產生更明顯的變化，包括服裝形狀、合身度與胸部周圍垂墜感的可見改變。

遵循這些指引可確保最佳的輸入品質，並最大化 AI 生成增強的真實度、寫實性與一致性。

• 支援的格式與尺寸

• 錯誤代碼

• 環境與相依性

點數消耗