Video Eraser API

PopNow

クリップ全体で固定領域を消去

popnow/video-eraser-v1/video-edit
  • 字幕の領域を消去

Video Eraser について

クリップ全体で固定領域を消去。

POST /jobs/createTask でモデル名に popnow/video-eraser-v1/video-edit を指定すれば呼び出せます。$0.024から。

このガイドは今のところ英語のみです。 →

リクエストパラメーター

パラメーター必須説明
mask_urlはい変えたい部分を塗ります。
promptいいえOptional short description of the objects or area to remove and the surrounding context.
video_urlはい加工する動画。

料金

料金は米ドル表示です。API は専用の米ドル残高を使用します。サイトのクレジットは API で使えず、API 残高との相互振替もできません。 タスクの受理時に、見積もりの上限額を API 残高から確保します。完了後は実際の使用量で精算し、確保額を超える請求はせず、差額を解放します。タスクが失敗した場合は確保額を解放します。

オプションUSD 入力の長さ一秒あたり
標準$0.024

入力の長さは秒単位で切り上げ、最低 3 秒として計算します。

実行前に同じリクエスト本文を POST /jobs/quote に送ると、想定料金と上限額を米ドルで確認できます。見積もりではタスクの実行も課金も行いません。

API クイックスタート

Video Eraser API を 3 ステップで呼び出す

  1. API キーを作成する. PopNow にログインし、API コンソールでキーを作成します。キーは sk-popnow- で始まり、API 呼び出しには専用の米ドル残高を使用します。
  2. リクエストを送る. POST /jobs/createTask に、model を popnow/video-eraser-v1/video-edit、input をパラメーター表どおりにして送ります。レスポンスですぐにタスク ID が返ります。
  3. 結果を受け取る. タスク ID で GET /jobs/recordInfo をポーリングするか、callBackUrl を渡せば結果がそこへ送られます。タスクが成功したら出力リンクからダウンロードします。
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "popnow/video-eraser-v1/video-edit",
  "input": {
    "prompt": "Remove the subtitles inside the white mask. Preserve the rest of the video.",
    "video_url": "https://media.popnow.ai/api-examples/video-eraser/subtitles-e1128ca9.mp4",
    "mask_url": "https://media.popnow.ai/api-examples/video-eraser/subtitles-mask-b701fc56.png"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

プロンプトとリンクはご自身のものに置き換えてください。API タブにレスポンス、ポーリング、コールバックのリファレンスがあります。

Video Eraser API についての質問

Video Eraser API の料金はいくらですか?

Video Eraserは$0.024/秒です。API は専用の米ドル残高を使用します。サイトのクレジットは API で使えず、API 残高との相互振替もできません。 タスクの受理時に、見積もりの上限額を API 残高から確保します。完了後は実際の使用量で精算し、確保額を超える請求はせず、差額を解放します。タスクが失敗した場合は確保額を解放します。

API でのVideo Eraserのモデル名は?

POST /jobs/createTask の model フィールドに 字幕の領域を消去は popnow/video-eraser-v1/video-edit を指定します。

時間範囲を選択できますか?

いいえ。同じ静止領域が送信したクリップ全体に適用されます。時間を選択するフィールドはありません。

マスクは移動する字幕を追跡しますか?

いいえ。マスクはフレーム内の固定座標にとどまります。マスクの外に移動した部分は対象になりません。

隠れている元の映像を復元しますか?

いいえ。マスク領域は推定した内容で補完されます。動き、輪郭、映像のその他の部分を元の映像と比較して確認してください。

Video Eraser API の制限は?

入力クリップの最長:600 s。この範囲を超えるリクエストは、課金される前に拒否されます。

コードを書かずにVideo Eraserを試せますか?

API キーなしで、API の米ドル残高を使って Playground から Video Eraser を実行できます。各実行は対応するコードとともに開発者の履歴に記録されます。

Video Eraser についてさらに