{"templateId":"api_docs","sharedDataIds":{"apiDocsStore":"api-docs-@l10n/zh-TW/reference/ai_background_removal.yaml","sidebar":"sidebar-@l10n/zh-TW/reference/sidebars.yaml"},"props":{"definitionId":"@l10n/zh-TW/reference/ai_background_removal.yaml","settings":{"baseUrlPath":"/zh-tw/reference/ai_background_removal"},"disableAutoScroll":true,"seo":{"title":"AI 照片去背","description":"YouCam API documentation by Perfect Corp. Learn how to use Skin analysis API, Virtual try-on API, Image editing API, and Video generative AI APIs.","siteUrl":"https://docs.perfectcorp.com","keywords":"AI Skin Analysis, AI Clothes, AI Hairstyle, AI Outfits","image":"/assets/favicon.cd6fa4d833b2a573b3c6dae68386b293da205b203402cb0c97b80bd2acc07ea2.8351e24f.png"},"dynamicMarkdocComponents":[],"metadata":{"type":"openapi","title":"AI 照片去背","version":"","description":"# 概述\n以無可挑剔的精準度移除照片背景，確保影像的高品質。\n* 自動背景偵測：：使用 AI 辨識並將主體與背景分離。\n* 高精度編輯：：在主體周圍提供乾淨且精準的邊緣。\n* 支援多種類別：人物、產品、動物、汽車、圖形等。\n* 易於串接其他 AI 任務：輸出的檔案 ID 可即刻串接到其他 AI 任務。\n\n![](https://plugins-media.makeupar.com/smb/blog/post/2023-11-03/54285311-7c65-4658-9e27-11bf5c8dfe56.jpg)\n\n## 整合指南\n* 如何執行 AI 照片去背\n1. **調整來源圖片尺寸**</br>\n  調整您的照片以符合支援的尺寸。細節請參考**[檔案規格與錯誤](#section/overview/File-Specs-and-Errors)**\n\n2. **使用 File API 上傳檔案**</br>\n  使用 ***/s2s/v2.0/file*** API 上傳目標使用者圖片。\n    - 圖片需求\n      - 細節請參考**[檔案規格與錯誤](#section/overview/File-Specs-and-Errors)**。\n    - ***重要***：僅呼叫 File API 並不會上傳您的檔案。您必須**手動上傳**檔案到**File API 回應中提供的網址**。該網址就是您的上傳目的地，請確保檔案成功傳輸到該處後再繼續。<br>\n    在呼叫 AI API 之前，請確保您的檔案已成功上傳。使用 File API 取得上傳網址，然後將檔案上傳到該位置。上傳完成後，您會在回應中取得 ***file_id***，這個 ID 就是您用於存取該檔案相關 AI 功能的依據。\n    \n      > **警告：** 請注意，若您未將檔案上傳到 File API 回應中提供的網址，使用 AI API 時會得到 500 Server Error / unknown_internal_error 或 404 Not Found 錯誤。\n\n3. **執行 AI 任務**</br>\n  上傳完成後，使用檔案 ID 呼叫 POST 'task/sod' 執行 AI 任務，並取得用於監控的 ***task_id***。\n\n4. **設定 webhook 或輪詢，以查詢任務狀態直到成功或錯誤**</BR>\n***task_id*** 用於設定 webhook 或實作輪詢，在整個保留期間監控任務狀態。在 AI 引擎完成任務之前，狀態會維持為 running。任務處於執行狀態時不會消耗點數。處理完成後，任務狀態會變為 success 或 error。\n\n1. **成功後取得 AI 任務的結果**</BR>\n引擎成功處理您的輸入檔案並生成結果影像後，任務會變為 'success' 狀態。您會取得處理後影像的網址，以及一個 dst_id，讓您在無需重新上傳結果圖片的情況下串接另一個 AI 任務。\n點數僅在這種情況下會被消耗。若引擎處理任務失敗，任務狀態會變為 'error'，且不會消耗點數。</BR>\n扣除點數時，系統會優先使用接近到期的點數。若到期日相同，則扣除最早取得的點數。\n\n* 示範情境：\n常見實作案例：\n![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/Transparen_Background_aca3cdbd83.jpg)\n\n## 輸入與輸出\n* 輸入\n   * `Image`\n- **類型：** `image`\n- **說明：** 具有清晰前景的影像。\n\n實際應用（輸入）： \n![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/yce_removal_bg_s4_poster_1_289b8eaf81.png)\n\n---\n\n* 輸出\n   * `前景圖片`\n- **類型：** `image`\n- **說明：** 已移除背景的影像。\n\n實際應用（輸出）：\n![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/yce_removal_bg_s4_poster_2_a6bc3c5f6a.png)\n\n## 檔案規格與錯誤\n* 支援的格式與尺寸\n\n|AI 功能|支援的尺寸|檔案大小|接受的格式|\n|  ----  | ----  | ----  | ----  |\n|AI 照片去背|輸入與輸出圖片的建議與限制如下：</br>解析度：4096 × 4096 像素（最長邊不得超過 4096 像素）|<10MB|JPG 與 PNG|\n\n* 錯誤代碼\n\n|錯誤代碼|說明|\n|  ----  | ----  |\n|exceed_max_filesize|輸入檔案大小超過上限|\n|invalid_parameter|參數值無效|\n|error_download_image|下載來源圖片錯誤|\n|error_download_mask|下載遮罩圖片錯誤|\n|error_decode_image|解碼來源圖片錯誤|\n|error_decode_mask|解碼遮罩圖片錯誤|\n|error_download_video|下載來源影片錯誤|\n|error_decode_video|解碼來源影片錯誤|\n|error_nsfw_content_detected|在來源圖片中偵測到 NSFW 內容|\n|error_no_face|來源圖片未偵測到臉部|\n|error_pose|在來源圖片偵測姿勢失敗|\n|error_face_parsing|在來源圖片進行人臉分割失敗|\n|error_inference|推論流程錯誤|\n|exceed_nsfw_retry_limits|超過重試上限，以避免生成 NSFW 圖片|\n|error_upload|上傳結果圖片錯誤|\n|error_multiple_people|在來源圖片中偵測到多人|\n|error_no_shoulder|來源圖片中肩膀不可見|\n|error_large_face_angle|上傳圖片的臉部角度過大|\n|error_hair_too_short|輸入的頭髮過短|\n|error_unexpected_video_duration|影片長度等於 dstDuration|\n|error_bald_image|輸入的髮型為禿頭|\n|error_unsupport_ratio|輸入圖片的長寬比不受支援|\n|unknown_internal_error|其他|\n\n---\n\n## 點數消耗\n\n| AI 功能 | 消耗的點數 |\n|---|---|\n| AI 照片去背 V1.0 | 1 |\n\n---\n"},"compilationErrors":[],"markdown":{"partials":{},"variables":{"rbac":{"teams":["anonymous"]},"user":{},"remoteAddr":{"hostname":"docs.perfectcorp.com","port":4000,"ipAddress":"216.73.217.126"},"lang":"zh-TW","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"master"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/zh-tw/reference/ai_background_removal","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}