# 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 メガバイト以下である必要があります。 **2. ファイルのアップロード** 以下のエンドポイントを通じて、アップロード URL とファイル ID をリクエストします。 ``` POST /s2s/v2.0/file ``` **3. AI タスクの実行** ``` POST /s2s/v2.0/task/bg-replace-vid ``` ファイル ID または画像 URL を入力として使用してタスクを送信します。レスポンスには、結果の追跡と取得に使用される task_id が返されます。 **4. タスク結果の取得** ``` GET /s2s/v2.0/task/bg-replace-vid/{task_id} ``` タスク ID を使用してステータスを追跡し、結果を取得します。 [Webhook](/develop/webhook) を設定すると、タスク完了時に成功またはエラーのステータスを含む非同期通知を受信できます。また、タスクエンドポイントを繰り返し呼び出して、ステータスが running から success または error に更新されるまでポーリングすることもできます。 料金は、タスクが正常に完了した場合にのみ課金されます。 --- ## ファイル仕様とエラー * 対応フォーマットと寸法 | AI 機能 | 対応寸法 | 対応ファイルサイズ | 対応フォーマット | | --- | --- | --- | --- | | AI 動画背景置換 | 出力は MP4 形式で、入力と同じ解像度、フレームレートは最大 30 フレーム/秒（入力がこの制限を超える場合は自動変換）、最大長は 600 秒（入力動画が長い場合は最初の 600 秒のみ保持）である必要があります。 背景画像は JPG または PNG 形式で、最大解像度は 4096 x 4096 ピクセル（長辺が 4096 ピクセル以下）、ファイルサイズは 10 メガバイト以下である必要があります。 | 動画長制限: 600s 背景画像: <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/ja/reference/ai_video_background_replace.yaml) ## V1.0 - [POST /s2s/v2.0/task/bg-replace-vid](https://docs.perfectcorp.com/ja/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/ - [GET /s2s/v2.0/task/bg-replace-vid/{task_id}](https://docs.perfectcorp.com/ja/reference/ai_video_background_replace/v1.0/paths/~1s2s~1v2.0~1task~1bg-replace-vid~1%7Btask_id%7D/get.md)