# AI 動画顔入れ替え # 概要 動画顔入れ替えは、YouCam の AI 動画顔入れ替え API で、動画内の人物の顔を別の人物の顔に置き換える AI 駆動のプロセスです。 高度な AI 技術により、AI 動画顔入れ替えは非常にリアルな結果を提供します。顔の表情、ライティング、肌色は細かく調整され、入れ替えた顔が元の映像とシームレスに融合するようにします。 > **備考:** この API は単一の顔を含む動画のみをサポートします。カスタマイズ可能なソリューションについては、[お問い合わせください](mailto:YouCamOnlineEditor_API@perfectcorp.com)。 使用例: ![](https://plugins-media.makeupar.com/smb/blog/post/2024-08-23/b1f96100-37d6-4c28-b467-d397e9c3a25d.jpg) ![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/dt_yce_video_face_swap_S3_video_03_28785ebe0c.jpg) ![](https://plugins-media.makeupar.com/smb/story/2024-09-12/3582f617-e88e-4219-9e72-43d4c26791cd.png) --- ## ファイル仕様とエラー * 対応フォーマットと寸法 | AI 機能 | 対応寸法 | 対応ファイルサイズ | 対応フォーマット | | --- | --- | --- | --- | | AI 動画顔入れ替え | 入力動画は 30 秒、4K 解像度、または 30 FPS を超えてはならず、出力は長辺 1280 解像度、30 FPS、最大 30 秒に制限されます。 | 長さ制限: 30s | コンテナ: 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 | パラメータ値が無効です | --- ## ユニット消費量 | AI 機能 | 消費ユニット | | --- | --- | | AI 動画顔入れ替え V1.0 | 1 (5 秒) * | > *画像数または動画の長さが割り切れない場合、ユニットは切り上げられます。 --- License: Privacy policy ## Servers ``` https://yce-api-01.makeupar.com ``` ## Security ### BearerAuthenticationV2 標準の 'Bearer authentication' を使用します。ヘッダーに `Authorization:Bearer YOUR_API_KEY` の形式で 'API Key' を設定してください。'Bearer' と 'YOUR_API_KEY' の間にスペースがある点にご注意ください。 Type: http Scheme: bearer ## Download OpenAPI description - [AI 動画顔入れ替え](https://docs.perfectcorp.com/_bundle/@l10n/ja/reference/ai_video_face_swap.yaml) ## V1.0 - [POST /s2s/v2.0/task/face-swap-vid](https://docs.perfectcorp.com/ja/reference/ai_video_face_swap/v1.0/paths/~1s2s~1v2.0~1task~1face-swap-vid/post.md): AI タスクは非同期です。機能ごとに Webhook がサポートされている場合は、Webhook による完了処理を優先します。Webhook エンドポイントを設定し、Webhook 署名を検証したうえで、`success` または `error` の通知が来たら、受け取った `task_id` を使ってタスクの結果を照会します。設定と検証の詳細は [Webhook 統合ガイド](/develop/ - [GET /s2s/v2.0/task/face-swap-vid/{task_id}](https://docs.perfectcorp.com/ja/reference/ai_video_face_swap/v1.0/paths/~1s2s~1v2.0~1task~1face-swap-vid~1%7Btask_id%7D/get.md)