{"templateId":"api_docs","sharedDataIds":{"apiDocsStore":"api-docs-@l10n/zh-TW/reference/ai_video_background_replace.yaml","sidebar":"sidebar-@l10n/zh-TW/reference/sidebars.yaml"},"props":{"definitionId":"@l10n/zh-TW/reference/ai_video_background_replace.yaml","settings":{"baseUrlPath":"/zh-tw/reference/ai_video_background_replace"},"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![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/Green_Screen_ddb7892393.png)\n\nAI 影片背景更換 API 讓您無縫加入任何您選擇的背景。您可以從廣泛的選項中選擇，包括風景、自訂圖片，甚至輕鬆的視覺，給予您完全的創作控制，為您的內容設計理想的場景。\n無需攝影棚或綠幕。您可以輕鬆更換影片背景，達到乾淨且專業的外觀。無論您想引入新的環境，或移除不想要的干擾，這解決方案非常適合製作引人入勝的影片與教學，無需昂貴的設備。\n\n\n---\n\n## 整合指南\n\n**1. 準備來源影片與背景圖片**\n輸出必須為 MP4 格式，解析度與輸入相同，影格率上限為每秒 30 影格（若輸入超過此限制會自動轉換），最大長度 600 秒（若輸入影片更長，僅保留前 600 秒）。\n\n背景圖片必須為 JPG 或 PNG 格式，最大解析度 4096 x 4096 像素，長邊不超過 4096 像素，檔案大小限制為 10 MB。\n\n\n**2. 上傳檔案**\n透過以下方式請求上傳網址與檔案 ID：\n\n```\nPOST /s2s/v2.0/file\n```\n\n\n**3. 執行 AI 任務**\n\n```\nPOST /s2s/v2.0/task/bg-replace-vid\n```\n\n使用檔案 ID 或圖片網址作為輸入提交任務。回應會回傳 task_id 用於追蹤與取得結果。\n\n\n**4. 取得任務結果**\n\n```\nGET /s2s/v2.0/task/bg-replace-vid/{task_id}\n```\n\n使用任務 ID 追蹤狀態並取得結果。k\n可 [Webhooks](/develop/webhook.md) 在任務完成時接收非同步通知，狀態為 success 或 error。也支援輪詢，重複呼叫任務端點直到狀態從 running 更新為 success 或 error。\n\n僅在任務成功完成時才計費。\n\n\n\n---\n\n## 檔案規格與錯誤\n\n* 支援的格式與尺寸\n\n|AI 功能|支援的尺寸|支援的檔案大小|支援的格式|\n| ---- | ---- | ---- | ---- |\n| AI 影片背景更換 | 輸出必須為 MP4 格式，解析度與輸入相同，影格率上限為每秒 30 影格（若輸入超過此限制會自動轉換），最大長度 600 秒（若輸入影片更長，僅保留前 600 秒）。
背景圖片必須為 JPG 或 PNG 格式，最大解析度 4096 x 4096 像素，長邊不超過 4096 像素，檔案大小限制為 10 MB。 | 影片長度限制：600 秒
背景圖片：<10MB | 容器：mp4
影像：MPEG-4, MPEG-4 AVC,
音訊：aac, amr, mp3 |\n\n* 錯誤代碼\n\n|錯誤代碼|說明|\n| ---- | ---- |\n| error_download_video | 下載來源影片錯誤 |\n| error_decode_video | 解碼來源影片錯誤 |\n| error_unsupported_video | 不支援的影片格式 |\n| exceed_max_filesize | 輸入檔案大小超過上限|\n| error_nsfw_content_detected | 在來源檔案中偵測到 NSFW 內容 |\n| error_decode_mask | 解碼遮罩圖片錯誤 |\n| invalid_parameter | 參數值無效|\n\n* 環境與相依性\n\n| 範例程式語言 / 工具 | 建議的執行環境版本 |\n|---|---|\n| cURL | - bash >= 3.2
- curl >= 7.58（現代 TLS/HTTP 支援）
- jq >= 1.6（穩健的 JSON 解析） |\n| Node.js（JavaScript） | Node >= 18（支援全域 fetch） |\n| JavaScript | - Chrome / Edge >= 80
- Firefox >= 74
- 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 影片背景更換 V1.0 | 2（1 秒）* |\n\n > *若圖片數量或影片長度無法整除，點數無條件進位。\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_video_background_replace","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}