AI 動画消しゴム
1. ソース動画とマスク画像の準備 入力動画の長さは 60 秒以下である必要があり、出力動画の長辺は 1920 ピクセル以下、フレームレートは 30 フレーム/秒以下である必要があります。
2. ファイルのアップロード 以下のエンドポイントを通じて、アップロード URL とファイル ID を取得します。
POST /s2s/v2.0/file入力動画:
参考入力マスク:
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 を設定すると、タスク完了時に成功またはエラーのステータスを含む非同期通知を受信できます。また、タスクエンドポイントを繰り返し呼び出して、ステータスが running から success または error に更新されるまでポーリングすることもできます。
課金は、タスクが正常に完了した場合にのみ発生します。
出力動画サンプル:
- 対応フォーマットと寸法
| 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 |
OpenAPI記述をダウンロード
言語
サーバー
https://yce-api-01.makeupar.com