はじめに
このエンドポイントの役割
動画を 1 本受け取り、各フレームで大きい順に最大 3 つの顔を復元して鮮明にしたコピーを返します。結果はフレーム間で安定しています。動き、構図、長さ、元の音声トラックは保たれ、解像度も変わりません。prompt はありません。
大事な入力
video_url は対象のクリップです。MP4 のアップロード、または公開 URL で、長さは 3 秒から 5 分です。範囲外のクリップは、課金の前に拒否されます。Video Face Enhancer には元画像で十分な大きさがあり、はっきり見える実在の人物の顔を選んでください。Video Face Enhancer のフレームごとの顔修復では、遠い顔や隠れた顔よりも、こうした細部を生かせます。
返ってくるもの
1 リクエストにつき、送ったものと同じ解像度、フレームレート、長さ、音声の動画が 1 本返ります。Video Face Enhancer には元画像で十分な大きさがあり、はっきり見える実在の人物の顔を選んでください。Video Face Enhancer のフレームごとの顔修復では、遠い顔や隠れた顔よりも、こうした細部を生かせます。画素数を増やしたい場合は /models/video-upscaler-v1 を使ってください。
| 項目 | 値 |
|---|---|
| 入力 | 動画 |
| 出力 | 動画 |
| エンドポイント | 動画編集 |
| 顔の数 | 1 フレームあたり大きい順に最大 3 つ |
| 操作項目 | prompt なし。クリップがリクエストのすべて |
| 課金 | 入力クリップの秒単位、最低 3 秒 |
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
video_url | はい | 復元するクリップです。MP4 のアップロード、または公開リンクで、長さは 3 秒から 5 分です。 1 文字以上 |
料金
$0.012 / 出力秒
入力クリップの長さに対して 1 秒単位で切り上げて課金します。最低課金時間は 3 秒です。アップロードの場合はその長さで、URL の場合は配信まで最大 5 分の長さで料金を確保し、差額は解放します。失敗したリクエストには課金されません。
ユースケース
ポッドキャストとインタビューのクリップ
アップロード用に強く圧縮された顔出しの映像は、まず顔の細部が失われます。一度通すと、部屋、構図、音を変えずに、目、歯、髪の生え際を取り戻せます。
古い映像や過剰に圧縮された映像
保存、共有、再エンコードを何度も重ねたクリップは、顔のまわりがぼやけてブロック状に見えます。1 フレームあたり最大 3 つの顔が復元されるので、はっきり話す人が 1 人か 2 人のクリップに最も向いています。
後で拡大する予定の映像
まず顔をきれいにし、より大きな画面に備えて画素数も必要なら、Video Upscaler（/models/video-upscaler-v1）を使ってください。
プロンプトガイドと実践のヒント
クリップを確認する
3 秒から 5 分の MP4 で、実在する人物の、ある程度大きくはっきり写った顔が含まれるもの。先に必要な部分だけに切り抜いてください。
video_urlを送るvideo_urlには MP4 のアップロードか公開リンクを指定します。指定するのはこの 1 項目だけです。Video Face Enhancer は送信した素材だけでVideo Face Enhancer のフレームごとの顔修復を行うため、プロンプトや修復スライダーの設定はありません。ポーリングして比べる
呼び出しは非同期です。タスクを作成し、完了までポーリングしてから、プラットフォームのストレージから動画をダウンロードします。元の映像と通常の再生速度、および一時停止したフレームで比べ、音声が損なわれていないか確認してください。
はじめに
Video Face Enhancer は、クリップのすべてのフレームにある顔を復元し、鮮明にします。video_url を送ると、ツールは各フレームで大きい順に最大 3 つの顔を見つけ、強い圧縮やぼけで失われた細部を組み直します。結果はフレーム間で安定したまま保たれます。動き、構図、長さ、元の音声トラックはそのまま残り、クリップは送ったのと同じ解像度で返ります。受け付けるのは長さ 3 秒から 5 分の MP4 ファイルで、prompt はありません。
主な機能と特長
すべてのフレームの顔をきれいに
復元は、1 枚の静止画ではなく、クリップ全体に対して行われます。テストでは、ポッドキャストの司会者を写した 5 秒の 640×360 のクリップを、強い H.264 圧縮で劣化させました。約 21 秒の処理後、640×360、24 fps のまま、長さ 5.0 秒で返りました。目、歯、髪の生え際は全フレームで鮮明になり、ちらつきはありませんでした。司会者は、同じ人物だと分かるままでした。
それ以外はそのまま
音声、動き、構図、長さは保たれ、顔の周囲には手を加えません。テストでは、司会者の背後の部屋は変わりませんでした。このツールは動画を拡大しません。画素数も増やしたい場合は Video Upscaler（/models/video-upscaler-v1）を使ってください。
料金はクリップの長さに従う
料金は入力クリップの長さに対して 1 秒単位で切り上げ、最低課金時間は 3 秒です。3 秒未満または 5 分を超えるクリップは、課金の前に拒否されます。長さを読み取れるアップロードのクリップでは、その長さで料金を確保します。URL の場合は、配信まで最大 5 分の長さで見積もりを確保し、差額は解放します。失敗したリクエストには課金されません。
活用例
ポッドキャストやインタビューのクリップ
アップロード用に強く圧縮された顔出しの映像は、まず顔の細部が失われます。クリップを一度通すと、部屋、カメラの構図、音を変えずに、目、歯、髪の生え際を取り戻せます。
古い映像や過剰に圧縮された映像
保存、共有、再エンコードを何度も重ねたクリップは、顔のまわりがぼやけてブロック状に見えます。大きい順に、1 フレームあたり最大 3 つの顔が復元されるので、はっきり話す人が 1 人か 2 人のクリップに最も向いています。
後で拡大する予定の映像
まず顔をきれいにし、より大きな画面で使うために画素数も必要なら、Video Upscaler（/models/video-upscaler-v1）を使ってください。
プロンプトガイドと活用のコツ
prompt はありません。クリップを選びます
入力は video_url だけです。MP4 のアップロード、または公開リンクで、長さは 3 秒から 5 分です。料金は送る長さに従うため、送信前に必要な部分だけに切り抜いてください。
復元しやすい顔を選ぶ
Video Face Enhancer には元画像で十分な大きさがあり、はっきり見える実在の人物の顔を選んでください。Video Face Enhancer のフレームごとの顔修復では、遠い顔や隠れた顔よりも、こうした細部を生かせます。イラストやアニメの顔、とても小さな顔、大きく隠れた顔や極端にぼけた顔は改善が小さくなります。同時に 3 つを超える顔が映るクリップでは、大きい 3 つが復元され、残りはそのまま残ります。
結果を元の映像と比べる
出力は通常の再生速度と、一時停止したフレームの両方で確認し、顔だけでなく音声、長さ、フレームレートも確かめてください。画像版のこのツールでは、肌が実際の写真より少しなめらかに仕上がりました。そのため、動いている顔にも同じ軟化がないか確認してください。背景には手を加えないため、そこの圧縮ブロックは残ります。元ファイルは残しておいてください。
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/face-enhancer-video-v1/video-edit",
"input": {
"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 リファレンスを参照してください。
