# AI 影片背景更換 # 概述 **AI 影片背景更換** ![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/Green_Screen_ddb7892393.png) AI 影片背景更換 API 讓您無縫加入任何您選擇的背景。您可以從廣泛的選項中選擇，包括風景、自訂圖片，甚至輕鬆的視覺，給予您完全的創作控制，為您的內容設計理想的場景。 無需攝影棚或綠幕。您可以輕鬆更換影片背景，達到乾淨且專業的外觀。無論您想引入新的環境，或移除不想要的干擾，這解決方案非常適合製作引人入勝的影片與教學，無需昂貴的設備。 --- ## 整合指南 **1. 準備來源影片與背景圖片** 輸出必須為 MP4 格式，解析度與輸入相同，影格率上限為每秒 30 影格（若輸入超過此限制會自動轉換），最大長度 600 秒（若輸入影片更長，僅保留前 600 秒）。 背景圖片必須為 JPG 或 PNG 格式，最大解析度 4096 x 4096 像素，長邊不超過 4096 像素，檔案大小限制為 10 MB。 **2. 上傳檔案** 透過以下方式請求上傳網址與檔案 ID： ``` POST /s2s/v2.0/file ``` **3. 執行 AI 任務** ``` POST /s2s/v2.0/task/bg-replace-vid ``` 使用檔案 ID 或圖片網址作為輸入提交任務。回應會回傳 task_id 用於追蹤與取得結果。 **4. 取得任務結果** ``` GET /s2s/v2.0/task/bg-replace-vid/{task_id} ``` 使用任務 ID 追蹤狀態並取得結果。k 可 [Webhooks](/develop/webhook) 在任務完成時接收非同步通知，狀態為 success 或 error。也支援輪詢，重複呼叫任務端點直到狀態從 running 更新為 success 或 error。 僅在任務成功完成時才計費。 --- ## 檔案規格與錯誤 * 支援的格式與尺寸 | AI 功能 | 支援的尺寸 | 支援的檔案大小 | 支援的格式 | | --- | --- | --- | --- | | AI 影片背景更換 | 輸出必須為 MP4 格式，解析度與輸入相同，影格率上限為每秒 30 影格（若輸入超過此限制會自動轉換），最大長度 600 秒（若輸入影片更長，僅保留前 600 秒）。 背景圖片必須為 JPG 或 PNG 格式，最大解析度 4096 x 4096 像素，長邊不超過 4096 像素，檔案大小限制為 10 MB。 | 影片長度限制：600 秒 背景圖片：<10MB | 容器：mp4 影像：MPEG-4, MPEG-4 AVC, 音訊：aac, amr, mp3 | * 錯誤代碼 | 錯誤代碼 | 說明 | | --- | --- | | error_download_video | 下載來源影片錯誤 | | error_decode_video | 解碼來源影片錯誤 | | error_unsupported_video | 不支援的影片格式 | | exceed_max_filesize | 輸入檔案大小超過上限 | | error_nsfw_content_detected | 在來源檔案中偵測到 NSFW 內容 | | error_decode_mask | 解碼遮罩圖片錯誤 | | invalid_parameter | 參數值無效 | * 環境與相依性 | 範例程式語言 / 工具 | 建議的執行環境版本 | | --- | --- | | cURL | - bash >= 3.2 - curl >= 7.58（現代 TLS/HTTP 支援） - jq >= 1.6（穩健的 JSON 解析） | | Node.js（JavaScript） | Node >= 18（支援全域 fetch） | | JavaScript | - Chrome / Edge >= 80 - Firefox >= 74 - Safari >= 13.1 | | PHP | PHP >= 7.4（現代 TLS/相容性），ext-curl（建議）或 allow_url_fopen=On + ext-openssl、ext-json | | Python | Python >= 3.10（支援 f-strings），requests >= 2.20.0 | | Java | Java 11+（支援 HttpClient），Jackson Databind >= 2.12.0 | --- ## 點數消耗 | AI 功能 | 消耗的點數 | | --- | --- | | AI 影片背景更換 V1.0 | 2（1 秒）* | > *若圖片數量或影片長度無法整除，點數無條件進位。 --- License: Privacy policy ## Servers ``` https://yce-api-01.makeupar.com ``` ## Security ### BearerAuthenticationV2 使用標準的 'Bearer authentication'。請將您的 'API Key' 放在標頭中：`Authorization:Bearer YOUR_API_KEY`。請注意 'Bearer' 與 'YOUR_API_KEY' 之間有一個空格。 Type: http Scheme: bearer ## Download OpenAPI description - [AI 影片背景更換](https://docs.perfectcorp.com/_bundle/@l10n/zh-TW/reference/ai_video_background_replace.yaml) ## V1.0 - [POST /s2s/v2.0/task/bg-replace-vid](https://docs.perfectcorp.com/zh-tw/reference/ai_video_background_replace/v1.0/paths/~1s2s~1v2.0~1task~1bg-replace-vid/post.md): AI 任務是非同步的。當功能支援 webhook 時，請優先使用以 webhook 為基礎的完成處理。設定您的 webhook 端點、驗證 webhook 簽章，並在收到 `success` 或 `error` 通知後，使用收到的 `task_id` 查詢任務結果。設定與驗證細節請見 [webhook 整合指南](/develop/webhook)。 若您的整合不支援 webhook 或無法使用 - [GET /s2s/v2.0/task/bg-replace-vid/{task_id}](https://docs.perfectcorp.com/zh-tw/reference/ai_video_background_replace/v1.0/paths/~1s2s~1v2.0~1task~1bg-replace-vid~1%7Btask_id%7D/get.md)