字幕と画像透かしの削除のための550W Video Eraser API

550W開発者APIが実際にサポートしていること

550W開発者APIでは、バックエンドから動画字幕やテキスト消去ジョブ、画像透かし除去ジョブを送信でき、ユーザーを手動エディター経由させる必要はありません。クリエイタープラットフォーム、ローカライゼーションパイプライン、メディアライブラリ、内部ツール向けに設計されており、組織が所有または編集ライセンスを持つコンテンツを繰り返し処理するために使用されます。

動画字幕とテキストの消去

動画の場合、/open/uploadVideoを通じてMP4またはMOVFootageをアップロードするか、/open/submitTaskにpublicvideoUrlを指定します。リクエストには動画の寸法、再生時間、修復する矩形領域が含まれます。動画ジョブは非同期で実行され、/open/taskDetailまたは/open/taskListでステータスを確認できます。

画像透かしの削除

画像の場合、/open/removeImageWatermarkはJPG、PNG、BMP、WebP、AVIF、TIFF、SVGファイル（最大50MB）を受け付けます。結果を待つことも、後で参照するための処理タスクを返すこともできます。Eraser開発者APIは動画リンク透かしのダウンロードを提供していないため、統合機能でその機能を約束しないでください。

許可された動画字幕・テキストクリーニングと画像透かし除去にはAPIを使用し、サポートされていない動画リンク透かしワークフローを製品約束に含めないでください。

本番対応の要求フロー

すべてのリクエストはuserNoとapiKeyで認証されます。両方の値をサーバーに保管してください。APIキーを браузер или мобильный клиентコードに入れると、用户や拡張機能に回復可能になります。视频はまずアップロードするか、公开到达可能なHTTPS URLとして提供できます。

認証とアップロード

width、height、duration、x1、y1、x2、y2を指定して/open/submitTaskを送信します。紧凑な矩形領域は、全画面修復よりも詳細をより多く保持する傾向があります。サポートされているワークフローで 보수的な再構成が必要な場合はmode=protectを使用し、removeAudioはオーディオを処理前に剥离する必要がある場合のみ使用してください。

べき等性のあるジョブの送信

128文字以内のべき等性キーを送信して、再試行安全な作成を実現します。提交後に接続が切断された場合は、2番目の請求可能なジョブを作成する代わりに、同じキーで再試行してください。返されたtaskIdを propia asset ID旁边に保管してください。

結果の受信と検証

非同期配信には、公开HTTPS callbackUrlを指定してください。webhookはタスクが最終状態に達したときにトリガーされます。ハンドラーは素早く確認応答し、/open/taskDetailで再度タスクを検証し、重複したwebhook配信を通常のものとして扱う必要があります。コールバックが遅延した場合の恢复パスとしてポーリングが便利です。

サーバー側の認証情報、べき等性、耐久性のあるタスクID、webhook検証により、再試行が安全で観測可能になります。

入力制限と品質管理

アップロードされた動画はMP4とMOV、最大ファイルサイズ1GB、再生時間最大600秒、文書化された寸法ルール内での最大1080p処理をサポートしています。フォーマット、再生時間、寸法ビット深度、HDRステータスを送信前に検証して、サポートされていないメディアが有料キューに入ることを防いでください。

クレジット消費前の検証

品質は字幕やテキストの背後で何が動いているかに依存します。平らな壁、空、ゆっくりと変化する風景は通常、手，头发、柄物の衣服、反射、高速カメラ移動よりも簡単です。边缘ケースのレビューキューを構築し、サムネイルだけでなくタイムライン全体を比較してください。

困難な映像の確認

画像ジョブは一般的なウェブとデザインのフォーマットをサポートし、現在のAPIページに記載されている成功したタスクごとの固定クレジット数を消費します。元のファイルを保存し、結果を派生物として保存してください。透かし除去は著作権や商用使用の許可を生み出しません。

サポートされていない入力を早期に拒否し、修復領域が重要な動く詳細を横切る場合は常に人間のレビューを求めてください。

請求、失敗、再試行ポリシー

動画字幕除去は再生時間と解像度で請求されます。現在の料金体系は720p以下で秒あたり1.3クレジット、720p超過1080pまでで秒あたり1.6クレジットです。したがって、30秒の1280×720動画は約39クレジット、30秒の1920×1080動画は約48クレジットです。大規模バッチを受け入れる前は/open/queryCreditsでクレジット数を確認してください。

送信前のコスト見積もり

成功レスポンスにはcodeとmessageが含まれ、タスクレスポンスにはステータスと、完了時にresultUrlが追加されます。失敗したタスクにはfailCode、failReason、refundStatusが含まれる場合があります。一時的な транспортまたは内部の失敗は指数関数的バックオフで再試行しますが、無効なパラメータ、サポートされていないメディア、アカウントの停止、クレジット不足のエラーは盲目的に再試行しないでください。

安定した失敗フィールドの処理

送信レイテンシ、完了レイテンシ、失敗率、レビュー却下率、承認済み資産あたりのコストを記録してください。これらのメトリクスは、自動化が単なる手動作業の移動ではなく、ワークフローを改善しているかどうかを示します。

有効な統合は、成功したHTTPレスポンスだけでなく、承認された出力と効果的なコストを測定します。

4ステップで統合をローンチ

まず、ローカライズされた550W開発者ページからAPIキーを生成し、代表的な動画を1つ送信してください。次に、タスク検索を実装し、自分の製品内で待機中、処理中、成功、失敗の各状態を表示してください。次に、べき等性とポーリング恢复を備えたwebhookを追加してください。最後に、制御されたバッチを実行し、コンカレンシーを増やす前にすべての出力を確認してください。

スケール前にパイロット

開発用と本番用のコントロールを分け、公開されている認証情報をローテートし、ソースメディアへのアクセスを制限し、結果の削除ポリシーを維持してください。明確な受入基準を持つチームは、DAM、CMS、ローカライゼーションパイプライン、またはクリエイターアップロードワークフローにAPIを接続しながら、エディトリアルレビューを犠牲にすることなく接続できます。