はじめに
このエンドポイントの役割
動画クリップを 1 本受け取り、同じクリップをより高い解像度の段階で返します。長さ、縦横比、動き、カット、音声トラックは送ったままで、prompt はありません。
大事な入力
video_url は 3〜60 秒のクリップで、ファイルへの直接リンクで渡します。resolution で出力の段階を選びます。720p、1080p（既定）、2k、4k です。段階は画素数の目安なので、832×480 のクリップは 1080p で 1896×1094 になります。
返ってくるもの
1 リクエストにつき元と同じ長さの MP4 が 1 本、タスク完了後にプラットフォームのストレージから配信されます。
| 項目 | 値 |
|---|---|
| 入力 | 動画 |
| 出力 | 動画 |
| エンドポイント | アップスケール |
| 段階 | 720p、1080p、2K、4K |
| 課金 | 元のクリップの秒数ごと、切り上げ、最低 3 秒 |
| 操作項目 | prompt なし。resolution のみ |
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
video_url | はい | アップスケールする 3〜60 秒のクリップです。動画ファイルへの直接リンクである必要があります。 1 文字以上 |
resolution | いいえ | 720p、1080p（既定）、2k、4k です。縦横比を保った画素数の目安なので、832×480 のクリップを 1080p にすると 1896×1094 で返ります。 |
料金
元のクリップの秒数ごとに課金し、次の整数秒に切り上げ、最低 3 秒です。1 秒あたりの単価は出力の段階で決まります。送信前の見積もりは、アップロードしたクリップなら長さに 1 秒を足した分、動画 URL なら上限の 60 秒で計算し、差額は精算時に解放されます。
| 仕様 | 料金 |
|---|---|
| $0.006 / 秒 |
| $0.006 / 秒 |
| $0.012 / 秒 |
| $0.024 / 秒 |
ユースケース
480p の下書きを納品品質に
480p や 720p で安く生成し、気に入ったテイクだけを 1080p や 4K にアップスケールします。すべての試行を高解像度で生成する費用がかかりません。
SNS と広告用の短尺
短いクリップを、フィードやランディングページ、広告枠が求める解像度まで、音声はそのままで引き上げます。
古い映像を大きな画面で
小さなアーカイブ映像や画面録画を、プレゼンや大型ディスプレイ向けに、よりきれいで大きな映像にします。
プロンプトガイドと実践のヒント
編集を終えてからアップスケールする
最終版をアップスケールしてください。そうしないと、後のすべての工程で数倍の画素を扱うことになります。
video_urlと resolution を送るvideo_urlが 3〜60 秒のクリップ、resolution で 720p、1080p（既定）、2k、4k を選びます。ほかに設定するものはありません。ポーリングしてダウンロードする
呼び出しは非同期です。タスクを作成し、完了までポーリングしてから、プラットフォームのストレージから MP4 を取得します。5 秒のクリップを 4K にすると約 19 MB です。
はじめに
Video Upscaler は仕上がったクリップを受け取り、より高い解像度の段階で返します。解像度だけを上げる工程で、編集は行いません。構図、動き、カット、タイミング、元の音声トラックはすべて送ったままです。prompt はありません。
リクエスト
{
"video_url": "https://example.com/clip.mp4",
"resolution": "1080p"
}
必須は video_url だけです。resolution の既定は 1080p で、ほかに 720p、2k、4k があります。
クリップの長さと課金
クリップは 3〜60 秒である必要があります。受付時に長さが分かる場合、範囲外のクリップはその場で受け付けません。分からない場合は処理開始前に確認し、範囲外ならタスクは失敗して全額返金されます。課金は元のクリップの秒数ごとで、次の整数秒に切り上げ、最低 3 秒、選んだ段階の単価です。送信前の見積もりは、アップロードしたクリップなら長さに 1 秒を足した分、動画 URL なら上限の 60 秒で計算し、使わなかった確保額は精算時に解放されます。
返ってくるもの
段階は画素数の目安で、縦横比は保たれます。832×480 のクリップは 1080p で約 33 秒の処理のあと 1896×1094 に、4k で約 103 秒のあと 3792×2188 になりました。5 秒の 4k MP4 は約 19 MB です。AAC の音声付き 854×480 のクリップは同じ音声のまま 1922×1080 で返りました。どのテストでも尺は元のクリップとフレーム単位で一致しています。
タスクの流れ
呼び出しは非同期です。タスクを作成し、終了状態になるまでポーリングしてから、プラットフォームのストレージから MP4 をダウンロードします。
ヒント
- 編集をすべて終えた最終版をアップスケールしてください。
- 今のクリップの解像度より上の段階を選んでください。
- 動画ファイルへの直接リンクを使ってください。動画を再生する Web ページを渡すと HTML が返り、長さを読めずに呼び出しが失敗し、料金は返金されます。ファイルをアップロードするのが最も確実です。
- できるだけきれいな元のクリップから始めてください。圧縮ブロックやノイズも一緒に拡大されます。
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-upscaler-v1/upscale",
"input": {
"resolution": "1080p",
"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 リファレンスを参照してください。
