AI 動画背景置換

概要

AI 動画背景置換

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 を設定すると、タスク完了時に成功またはエラーのステータスを含む非同期通知を受信できます。また、タスクエンドポイントを繰り返し呼び出して、ステータスが 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 秒) *

*画像数または動画長が均等に割り切れない場合、ユニットは切り上げられます。

OpenAPI記述をダウンロード

概要

メール

ライセンス

言語

サーバー

https://yce-api-01.makeupar.com