{"templateId":"api_docs","sharedDataIds":{"apiDocsStore":"api-docs-@l10n/zh-TW/reference/ai_photo_background_change.yaml","sidebar":"sidebar-@l10n/zh-TW/reference/sidebars.yaml"},"props":{"definitionId":"@l10n/zh-TW/reference/ai_photo_background_change.yaml","settings":{"baseUrlPath":"/zh-tw/reference/ai_photo_background_change"},"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":"# 概述\nAI 圖片換背景 API 透過將主體與原始背景隔離來增強影像，支援廣泛的應用，包括商業中以產品為中心的應用案例。\n\n這個 API 讓開發者使用自訂提示詞或預先定義的範本更換背景。\n\n**使用範例**\n\n之前：\n![](https://yce.makeupar.com/assets/images/sod/banner/change/yce-topbanner-dt-before.jpg)\n\n之後：\n![](https://yce.makeupar.com/assets/images/sod/banner/change/yce-topbanner-dt-after.jpg)\n\n\n之前：\n![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/yce_change_bg_s5_poster_before_0753db3e02.jpg)\n\n之後：\n![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/yce_change_bg_s5_poster_after_7fb288fde2.jpg)\n\n---\n\n## 整合指南\n\n**1. 上傳圖片**\n\n透過以下方式請求上傳網址與檔案 ID：\n\n```\nPOST /s2s/v2.0/file\n```\n\n使用回傳的網址上傳圖片。\n或者，提供託管在您自有儲存空間、可公開存取的圖片網址。\n\n\n**2. 準備背景描述提示詞，或選擇背景範本。**\n\n```\nGET /s2s/v2.0/task/template/bg-replace\n```\n\n取得預先定義的背景範本清單，並以其 template_id 選擇其一。使用 prompt（預設）時，背景會依據提供的提示詞生成。使用 template 時，背景會由 template_id 指定的預先定義範本生成，prompt 參數將被忽略。\n\n\n**3. 執行分析任務**\n\n```\nPOST /s2s/v2.0/task/bg-replace\n```\n\n使用檔案 ID 或圖片網址作為輸入，並附上理想的背景提示詞，提交任務。\n回應會回傳 task_id 用於追蹤與取得結果。\n\n\n**4. 取得任務結果**\n\n```\nGET /s2s/v2.0/task/bg-replace/{task_id}\n```\n\n使用任務 ID 追蹤狀態並得結\n\n可設定 [Webhooks](/develop/webhook.md) 在任務完成時接收非同步通知，狀態為 success 或 error。也支援輪詢，重複呼叫任務端點直到狀態從 running 更新為 success 或 error。\n\n僅在任務成功完成時才計費。\n\n---\n\n## 檔案規格與錯誤\n\n* 支援的格式與尺寸\n\n|AI 功能|支援的尺寸|支援的檔案大小|支援的格式|\n|  ----  | ----  | ----  | ----  |\n| AI 圖片換背景 | 較長邊不得超過 4096 像素。 | < 10MB | jpg/jpeg/png |\n\n* 錯誤代碼\n\n|錯誤代碼|說明|\n|  ----  | ----  |\n| exceed_max_filesize |\t輸入檔案大小超過允許的上限。 |\n| size_mismatch_on_input_image_and_mask | 輸入圖片尺寸必須與輸入遮罩圖片的尺寸相符。 |\n| invalid_parameter | 參數值無效。請求參數缺失、格式無效，或包含不支援的值。|\n\n* 環境與相依性\n\n| 範例程式語言 / 工具 | 建議的執行環境版本 |\n|---|---|\n| cURL | - bash >= 3.2</br>   - curl >= 7.58（現代 TLS/HTTP 支援）</br>   - jq >= 1.6（穩健的 JSON 解析） |\n| Node.js（JavaScript） | Node >= 18（支援全域 fetch） |\n| JavaScript | - Chrome / Edge >= 80</br>   - Firefox >= 74</br>   - Safari >= 13.1 |\n| PHP | PHP >= 7.4（現代 TLS/相容性），ext-curl（建議）或 allow_url_fopen=On + ext-openssl、ext-json |\n| Python | Python >= 3.10（支援 f-strings），requests >= 2.20.0 |\n| Java | Java 11+（支援 HttpClient），Jackson Databind >= 2.12.0 |\n\n---\n\n## 點數消耗\n\n| AI 功能 | 消耗的點數 |\n|---|---|\n| AI 圖片換背景 V2.0 | 4 |\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_photo_background_change","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}