# AI 影片物件移除

# 概述
**AI 影片物件移除**
![](https://plugins-media.makeupar.com/smb/blog/post/2025-02-04/webp_537ec670-48c0-49fc-b96b-8073de21a64b.webp)
AI 影片物件移除 API 能無縫移除影片內容中不想要的元素。無論是擠滿遊客的擁擠背景、雜亂的環境（如放著衛生紙與瓶子的桌面），或玻璃表面上令人分心的倒影，API 都能以高準確度與一致性，精準可靠地消除遮罩區域。


---

## 整合指南
**1. 準備來源影片與遮罩圖片**
輸入影片長度不得超過 60 秒，輸出影片的長軸須為 1920 像素或以下，影格率為每秒 30 影格或以下。
**2. 上傳檔案**
透過以下方式請求上傳網址與檔案 ID：

```
POST /s2s/v2.0/file
```
輸入影片：
![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/webp_video_object_removal_input_edd43a2470.png)
參考輸入遮罩：
![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/webp_video_object_removal_mask_4a1c9fb658.png)
**3. 執行 AI 任務**

```
POST /s2s/v2.0/task/obj-rem-vid
```
使用檔案 ID 或圖片網址作為輸入提交任務。回應會回傳 task_id 用於追蹤與取得結果。
**4. 取得任務結果**

```
GET /s2s/v2.0/task/obj-rem-vid/{task_id}
```
使用任務 ID 追蹤狀態並取得結果。
可設定 [Webhooks](/develop/webhook) 在任務完成時接收非同步通知，狀態為 success 或 error。也支援輪詢，重複呼叫任務端點直到狀態從 running 更新為 success 或 error。
僅在任務成功完成時才計費。
輸出影片範例：
![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/webp_video_object_removal_output_eb7670cd9e.png)


---

## 檔案規格與錯誤
* 支援的格式與尺寸

| AI 功能 | 支援的尺寸 | 支援的檔案大小 | 支援的格式 |
|  --- | --- | --- | --- |
| AI 影片物件移除 | 輸入影片長度不得超過 60 秒，輸出影片的長軸須為 1920 像素或以下，影格率為每秒 30 影格或以下。 | 長度限制：60 秒 | 容器：mov, 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 影片物件移除 V2.1 | 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_object_removal.yaml)

## V2.1

 - [POST /s2s/v2.0/file/obj-rem-vid](https://docs.perfectcorp.com/zh-tw/reference/ai_video_object_removal/v2.1/paths/~1s2s~1v2.0~1file~1obj-rem-vid/post.md): 要上傳新檔案，您必須先使用 File API。它會提供一個網址——請使用該網址上傳您的檔案。上傳完成後，您可以使用同一個回應中的 file_id，開始使用我們的 AI 功能。
 - [POST /s2s/v2.0/task/obj-rem-vid](https://docs.perfectcorp.com/zh-tw/reference/ai_video_object_removal/v2.1/paths/~1s2s~1v2.0~1task~1obj-rem-vid/post.md): AI 任務是非同步的。當功能支援 webhook 時，請優先使用以 webhook 為基礎的完成處理。設定您的 webhook 端點、驗證 webhook 簽章，並在收到 `success` 或 `error` 通知後，使用收到的 `task_id` 查詢任務結果。設定與驗證細節請見 [webhook 整合指南](/develop/webhook)。 若您的整合不支援 webhook 或無法使用
 - [GET /s2s/v2.0/task/obj-rem-vid/{task_id}](https://docs.perfectcorp.com/zh-tw/reference/ai_video_object_removal/v2.1/paths/~1s2s~1v2.0~1task~1obj-rem-vid~1%7Btask_id%7D/get.md)