# AI 動画消しゴム # 概要 **AI 動画消しゴム** ![](https://plugins-media.makeupar.com/smb/blog/post/2025-02-04/webp_537ec670-48c0-49fc-b96b-8073de21a64b.webp) AI 動画消しゴム API で、動画から不要な要素を除去できます。観光客で混雑した背景、散らかったデスク、ガラス表面の反射など、マスクした領域を除去します。 --- ## 統合ガイド **1. ソース動画とマスク画像の準備** 入力動画の長さは 60 秒以下である必要があり、出力動画の長辺は 1920 ピクセル以下、フレームレートは 30 フレーム/秒以下である必要があります。 **2. ファイルのアップロード** 以下のエンドポイントを通じて、アップロード URL とファイル 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 または画像 URL を入力としてタスクを送信します。レスポンスには、結果の追跡と取得に使用される task_id が返されます。 **4. タスク結果の取得** ``` GET /s2s/v2.0/task/obj-rem-vid/{task_id} ``` タスク ID を使用してステータスを追跡し、結果を取得します。 [Webhook](/develop/webhook) を設定すると、タスク完了時に成功またはエラーのステータスを含む非同期通知を受信できます。また、タスクエンドポイントを繰り返し呼び出して、ステータスが 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 フレーム/秒以下である必要があります。 | 長さ制限: 60s | コンテナ: 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/ja/reference/ai_video_object_removal.yaml) ## V2.1 - [POST /s2s/v2.0/file/obj-rem-vid](https://docs.perfectcorp.com/ja/reference/ai_video_object_removal/v2.1/paths/~1s2s~1v2.0~1file~1obj-rem-vid/post.md): 新しいファイルをアップロードするには、まず File API を使用する必要があります。URL が発行されるので、その URL を使用してファイルをアップロードします。アップロードが完了すると、同じレスポンス内の file_id を使用して AI 機能を利用開始できます。 - [POST /s2s/v2.0/task/obj-rem-vid](https://docs.perfectcorp.com/ja/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/ - [GET /s2s/v2.0/task/obj-rem-vid/{task_id}](https://docs.perfectcorp.com/ja/reference/ai_video_object_removal/v2.1/paths/~1s2s~1v2.0~1task~1obj-rem-vid~1%7Btask_id%7D/get.md)