{"templateId":"api_docs","sharedDataIds":{"apiDocsStore":"api-docs-@l10n/ja/reference/ai_video_background_replace.yaml","sidebar":"sidebar-@l10n/ja/reference/sidebars.yaml"},"props":{"definitionId":"@l10n/ja/reference/ai_video_background_replace.yaml","settings":{"baseUrlPath":"/ja/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\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 メガバイト以下である必要があります。\n\n\n**2. ファイルのアップロード**\n以下のエンドポイントを通じて、アップロード URL とファイル 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 または画像 URL を入力として使用してタスクを送信します。レスポンスには、結果の追跡と取得に使用される task_id が返されます。\n\n\n**4. タスク結果の取得**\n\n```\nGET /s2s/v2.0/task/bg-replace-vid/{task_id}\n```\n\nタスク ID を使用してステータスを追跡し、結果を取得します。\n\n[Webhook](../develop/webhook.md) を設定すると、タスク完了時に成功またはエラーのステータスを含む非同期通知を受信できます。また、タスクエンドポイントを繰り返し呼び出して、ステータスが 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 メガバイト以下である必要があります。 | 動画長制限: 600s
背景画像: <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.216.250"},"lang":"ja","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"master"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/ja/reference/ai_video_background_replace","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}