はじめに
このエンドポイントの機能
2 つのモードで動画 1 本を修復します。decompress はマクロブロック、リンギング、バンディング、色にじみを除去し、deblur はピンぼけした映像を鮮明にします。構図、動き、長さ、音声は保ちます。
主な入力
video_url は最大 120 秒の動画です。restore_mode で修復方法、resolution で出力サイズ(元のサイズ以下)を選びます。prompt と seed は任意です。
返される結果
元の縦横比、フレームレート、音声を保った MP4 を 1 本返します。
| 項目 | 値 |
|---|---|
| 入力 | 動画 |
| 出力 | 動画 |
| エンドポイント | 動画編集 |
| モード | decompress(圧縮劣化)または deblur(ピンぼけ) |
| 任意設定 | 場面の説明と seed |
| 課金 | 解像度に応じ元動画を秒単位、最低 3 秒分 |
主な機能とハイライト
ブロックを除去し、顔を再構成
4 秒の温室動画を 116 kbps まで圧縮し、女性の顔がブロック状に崩れる状態にしました。decompress は元の長さとフレームレートを保ち、巻き毛、笑顔、蘭が鮮明な 854×480 の動画を返しました。
ぼやけた 2 人の映像を鮮明に
ピンぼけを模してぼかしたワインセラーの会話映像は、顔、髪、木の樽が鮮明になりました。2 人の位置と動きは保たれました。
まず修復、その後で拡大
修復は元のサイズ以下で行います。修復した動画を大きくする必要があれば Video Upscaler に送ります。ブロックのある動画をそのまま拡大しても、ブロックが大きくなるだけです。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
video_url | はい | 修復する最大 120 秒の動画。MP4 か WebM のアップロードか直接リンクを指定します。 1 文字以上 |
restore_mode | いいえ | decompress(初期値)は低ビットレート動画のマクロブロック、リンギング、バンディング、色にじみを除去します。deblur はピンぼけを鮮明にしますが、動体ぶれは補正しません。 |
prompt | いいえ | 任意です。"a man and a woman talking in a wine cellar" など動画の短い説明で、正しい細部を保つ助けになります。 1000 文字以内 |
resolution | いいえ | 出力解像度は 480p、720p(初期値)、1080p です。縦横比を維持し、元より大きくなりません。 |
seed | いいえ | 再現可能な結果のための任意の整数です。空欄ではランダムな seed を使います。 |
料金
選択した出力解像度の料金で、元動画の長さを秒単位で切り上げ、最低 3 秒分を課金します。120 秒超は送信時に拒否されます。モード、prompt、seed で料金は変わりません。失敗したリクエストは無料です。
| 仕様 | 料金 |
|---|---|
| $0.024 / 秒 |
| $0.048 / 秒 |
| $0.12 / 秒 |
ユースケース
繰り返し共有された動画の修復
複数のアプリや再アップロードを経た動画には、ブロックやにじみが生じます。decompress は顔、髪、質感をきれいにします。
ピンぼけしたテイクの救済
オートフォーカスが迷ったり、被写体がピント面から外れた場合に、deblur で撮り直しなしに使えるテイクを取り戻せることがあります。
拡大の前処理に
まず元のサイズで修復し、1080p や 4K が必要なら、きれいにした動画を Video Upscaler に送ります。
プロンプトガイドと実践のヒント
損傷に合うモードを選びます
強い圧縮によるマクロブロック、バンディング、色にじみには decompress を使います。ピンぼけで鮮明さを失った映像には deblur を使います。動体ぶれは補正できません。
出力解像度を設定します
480p、720p、1080p から選びます。縦横比は維持され、元より大きくはならないため、元動画の高さ以下を選んでください。料金は選択した解像度に従います。
細部が重要なら場面を説明します
任意の prompt に "a woman with curly hair in a greenhouse full of orchids" などを指定すると、正しい細部を保つ助けになります。結果の再現には seed を加えます。
はじめに
Video Restorer は映像内の出来事を変えずに損傷を修復します。低ビットレートや繰り返しの再アップロードによる劣化には decompress、ピントが合わなかった動画には deblur を選びます。被写体、構図、動きは保ちます。
リクエスト
{
"video_url": "https://example.com/clip.mp4",
"restore_mode": "decompress",
"resolution": "720p",
"prompt": "a woman with curly hair in a greenhouse full of orchids"
}
必須は video_url のみです。restore_mode の初期値は decompress、resolution は 720p です。縦横比を維持し元より大きくしないため、480p の動画は高い設定でも 480p で返ります。
テストで確認した結果
4 秒、854×480 の温室動画を 116 kbps に圧縮し、女性の顔がブロック状になる状態にしました。480p の decompress では約 55 秒後、顔、巻き毛、蘭がきれいになり、4 秒、24 fps、ステレオ音声を保って返りました。ピンぼけを模してぼかした 4 秒のワインセラー動画は、deblur で約 72 秒後、顔と樽が鮮明になりました。
タスクの流れ
呼び出しは非同期です。タスクを作成し、完了までポーリングして、SpicyAPI ストレージから MP4 をダウンロードします。選択した解像度で元動画の長さに秒単位で課金し、失敗したリクエストは無料です。
ヒント
resolutionは元動画の高さ以下にします。高い設定はピクセルを増やさず料金だけが増えます。deblurはピンぼけ向けです。動体ぶれや手ぶれは補正の対象外です。- 修復後の動画を拡大するには Video Upscaler (
/models/video-upscaler-v1) に送ります。
API クイックスタート
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/video-restorer-v1/video-edit",
"input": {
"resolution": "720p",
"restore_mode": "decompress",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。


