使用ガイド
HiAPI API で topaz-upscale/video を使用する:ショート動画の画質向上ワークフロー
フレーム補間、強化設定、そして動作する縦型動画 HiAPI リクエスト
このページの内容
ショート動画に独自の画質向上ソリューションが必要な理由
縦型ショート動画——スマートフォン画面上で15〜60秒間視聴されるクリップ——は、長編動画とは異なる形で問題が発生します。横長のドキュメンタリーでは、モーションブラーや背景のディテールが画面の柔らかさを隠してくれます。しかし縦型クリップは視聴者が集中して見るものであり、狭いフレームにクロップされ、さらにホスティングプラットフォームによって再圧縮されることがよくあります。ソース映像の弱点は許容されるどころか、増幅されます。
これにより、画質向上が解決すべき問題が変わります。長編素材の場合、マスターファイルの画質を一度向上させれば完了かもしれません。しかしショート動画の場合、扱うソースファイルはすでにモバイル向けに1回(あるいは2回)エンコードされ、その後さらに再エンコードするプラットフォームに配信されています。目標は単により高い解像度の数値ではなく、次の圧縮に耐えられるファイルです。つまり、エッジがクリーンで、動きが安定し、フレーム全体のディテールが一貫していることです。
したがって、これは単一の呼び出しではなく、パイプラインとして捉えてください:
- 正規化:ソースを正確な編集ポイントにクロップし、アスペクト比を固定し、画質向上の前にフレームレートを決定します。
- 画質向上と強化:
topaz-upscale/videoを使用し、フレーム補間と強化を慎重に設定します。 - 検証:出力がソースと一致していることを確認してから公開します。画質向上は映像をシャープにする一方で、テクスチャを平坦化しやすいからです。
各ステップには独自の失敗モードがあります。クリップを誤ってカットすると実行時間を浪費します。不注意な補間は不自然な動きを生み出します。検証をスキップすると、瑕疵がそのまま視聴者に届きます。このガイドの残りの部分では、各決定を順に説明し、その後、自分の素材に合わせて適応できる実際の HiAPI リクエストを示します。

HiAPI 上の topaz-upscale/video の機能
topaz-upscale/video は HiAPI モデルカタログの動画画質向上エンドポイントです。動画素材と設定を送信すると、画質が向上した動画が返されます。これがすべての約束であり、残りは設定です。
処理チェーン内での位置づけは次のとおりです:
- 入力:API が取得できる動画、通常はソースファイルの URL。アスペクト比の正規化と編集はこのステップの前に完了済みです。モデルは与えられた内容のみを向上させます。
- 処理:サービスは指定された画質向上と強化設定(有効にした場合はフレーム補間を含む)でクリップを処理します。
- 出力:タスク結果で参照される画質向上済みの動画素材。ダウンロードして公開ステップに渡します。
開発者向けの実用的な注意点:
- これはタスクであり、同期応答ではありません。動画処理は長さと設定に比例して時間がかかるため、API は最初の応答で完成ファイルではなくタスク(ポーリングまたは待機用)を返します。
- 実行時間はクリップの長さに応じて増加します。長いクリップや重い設定はより多くの処理時間を消費します。ショート動画はこの点で有利です——反復コストが低いのです。
- パラメータはオンラインドキュメントが基準です。
topaz-upscale/videoの正確なパラメータ名、許容値、デフォルト値は HiAPI の現在のモデルドキュメントで定義されています。デスクトップツールや他社製品が類似の名称を使用しているからといって、パラメータが存在すると仮定しないでください。構築前にモデルページを確認してください。
このモデルはパイプライン内の正確に1つの位置を占めます:正規化の後、検証と公開の前です。この境界を明確に保てば、ワークフローの残りはシンプルなままです。

ショート動画のリズムに合わせたフレーム補間の計画
フレーム補間は中間フレームを合成して実効フレームレートを高めます——たとえば24または30fpsのソースをより滑らかな60fps出力にします。ショート動画では、滑らかな動きが高級に見えるため、どこでも有効にしたくなります。しかしその直感は通常間違っています。
補間が役立つ場合
- 速いパンやウィップパン。縦型クリップでは速い動きがよく使われ、低フレームレートではぎこちなく見えます。補間はスイープする動きを滑らかにします。
- スローモーションや可変速シーケンス。低フレームレートで撮影してから遅くする場合、補間はギャップを埋め、カクつきを減らします。
- ソースフレームレートが目標に近い場合。30fpsから60fpsへの向上は適度で予測可能な改善です。
コストだけが増え、目に見える利益がない場合
- 静的なトーキングヘッドショット。フレームがほとんど変わらない場合、補間フレームは周囲とほぼ同じです。実行時間を無駄に支払うことになります。
- すでに高フレームレートのソース。60fpsを120fpsに補間しても、プラットフォームの再エンコードでどうせ耐えられない可能性があります。
- 激しいモーションブラーや極端に低品質なソース。補間ははっきり見えない動きを推測し、その推測はエッジ付近で歪みやゴーストとして現れます。
慎重なデフォルト設定
ほとんどのショート動画作業では、補間をオフにして開始し、ソースフレームレートで画質を向上させ、結果を確認します。動きがぎこちない場合は、問題を解決できる最低の目標フレームレートで補間を有効にします。一度に1つの変数だけを変更すれば、何が改善——あるいは瑕疵——をもたらしたかを知ることができます。
補間は実行時間と相互に影響することも覚えておいてください。補間フレームごとに追加の作業が発生します。15秒のクリップでは違いは小さいですが、数百のバッチでは積み重なります。設定をキュー全体に適用する前に、代表的なクリップで測定してください。
推測せずに強化設定を選ぶ
強化設定は、モデルがシャープ化、ノイズ除去、ディテール復元をどれだけ強く行うかを制御します。適切な量はソースの品質とクリップの公開場所によって異なるため、普遍的な「最適」構成は存在しません。
目標からではなくソースから始める
設定に触れる前に、入力について2つの質問をしてください:
- ソースはどれだけクリーンか?クリアなカメラの生素材は軽度の強化に耐えます。重度に再圧縮された、または低ビットレートのソースはより慎重さが必要です。強化は圧縮アーティファクトと実際のディテールを一緒に増幅するからです。
- プラットフォームは何をするか?主要なショート動画プラットフォームはすべてアップロードを再エンコードします。あなたのモニターでよく見える攻撃的なシャープ化は、2回目のエンコード後にリンギングやハローになる可能性があります。
実用的な意思決定フレームワーク
- 高品質な生素材、適度な向上:保守的な強化を使用します。アップスケーラーに仕事を任せ、シャープ化を最小限に抑えて、テクスチャがプラットフォーム圧縮後も生き残るようにします。
- 柔らかい、または圧縮済みのソース:まずノイズ除去に頼り、その後適度にシャープ化します。ノイズの多いソースを過度にシャープ化すると、元の柔らかさよりも見苦しい硬いエッジが生成されます。
- テキスト、顔、製品ディテール:ショート動画クリップはしばしば読みやすい字幕とクリアな顔に依存します。これらの領域を特に検証してください——風景に役立つ強化が細かいテキストをぼやけさせる可能性があります。
- 動きの多いクリップ:保守的な強化を補間の決定と組み合わせます。強いシャープ化と補間は、フリッカーアーティファクトの最も一般的な原因です。
実際に利用可能なオプションを確認する
正確な強化パラメータ、その許容範囲、およびプリセットは、HiAPI の topaz-upscale/video オンラインモデルドキュメントで定義されています。パラメータ名とデフォルト値は変更される可能性があり、他のツールで使用したものと一致するとは限りません。モデルページを読み、リクエストで値を明示的に設定し、記憶に頼らないでください。不明な場合は、同じ短いクリップで2つの設定を実行して比較してください——バッチ全体で推測するより安価です。
実際に動作する topaz-upscale/video の HiAPI リクエスト
リクエストを書く前に、2つの環境変数を設定して API キーがソース管理に入らないようにします:
export HIAPI_API_KEY="your_api_key_here"
export SOURCE_VIDEO="https://your-bucket.example.com/clips/cut_vertical.mp4"
次にタスクを送信します。以下の構造がパターンです:リクエストをモデルに向け、ソース動画 URL を渡し、画質向上と補間設定を明示的に含めます。HiAPI モデルドキュメントで topaz-upscale/video の正確なパラメータ名と許容値を確認し、リクエストボディを一致するように調整してください。
curl -X POST "https://api.hiapi.ai/v1/models/topaz-upscale/video/jobs" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"video_url": "'"$SOURCE_VIDEO"'"
},
"settings": {
"upscale": {
"target_resolution": "1080p"
},
"frame_interpolation": {
"enabled": false
},
"enhancement": {
"strength": "conservative"
}
}
}'
何を期待し、どう対応するか:
- 応答にはタスク識別子とステータスが含まれます。タスク ID を保存してください——結果を取得するために必要です。
- ポーリングまたは待機。短いクリップはすぐに完了しますが、最初の読み取りで完了したと仮定せず、保留状態を処理できるようにクライアントを常に実装してください。
- 出力素材を取得し、完了したタスクから自分のストレージにダウンロードしてから公開キューに追加します。
- パッチではなく再送信。補間を有効にしてテストしたい場合は、フラグを変更した新しいタスクを送信します。各タスクで1つの変数だけを保持すれば、比較が誠実になります。
最初のリクエストは最速の検証でもあります:自動化を構築する前に、自分のクリップ、実際のアスペクト比と長さで実行してください。

結果を検証し、画質向上をパイプラインに統合する
画質向上したファイルが自動的に優れたファイルになるわけではありません。検証がモデル呼び出しを信頼できるワークフローに変えるステップです。
チェックすべきこと
- エッジと細部。テキスト、顔、ハードエッジを拡大します。ソースにはなかったハロー、リンギング、ぼやけたテクスチャを探します。
- 動きの一貫性。速い動きのクリップを通常速度で視聴します。補間アーティファクトは単一フレームで歪みやゴーストとして現れます——一時停止してフレームごとに確認してください。
- 色と露出。出力に色調や明るさのずれがないことを確認します。強化は微妙にコントラストを変える可能性があります。
- 音声と長さ。クリップの長さが同じで、音声トラックがミリ秒まで完全であることを確認します。再エンコード後にドリフトする音声トラックは字幕同期を壊します。
- プラットフォーム圧縮後。テストコピーを非公開でアップロードし、再エンコードされたバージョンを確認します。それが視聴者が実際に見るものだからです。
パイプライン内の配置
クリーンなショート動画パイプラインは次のとおりです:
- 編集してエクスポート:最終クリップをネイティブ解像度と安定したフレームレートで出力します。
- ソースファイルをアップロード:API がアクセスできるストレージに。
- 画質向上タスクを送信:明示的な設定で、タスク ID をクリップとともに記録します。
- ダウンロードして検証:上記のチェックを使用して出力を確認します。
- 公開:直接公開するか、クロスプラットフォームのスケジュール公開キューに入れます。
運用上の注意が2つあります。元のソースファイルを保持してください。画質向上したバージョンで上書きしないでください。異なる設定で再実行したくなるからです。そして各クリップの設定を記録してください。出力がおかしい場合に、どの構成がそれを生成したかを正確に追跡できるようにするためです。この追跡可能性により、バッチごとに再推測するのではなく、時間をかけて設定を調整できます。
コスト、制限、およびスケール前に確認すべき事項
本番トラフィックを topaz-upscale/video にルーティングする前に、他のツールに基づいて仮定するのではなく、HiAPI の現在のモデルドキュメントで運用詳細を確認してください。
- 課金基準。モデルがどのように課金されるか——たとえば出力時間または解像度ティアごと——を理解し、リアルタイムの価格パネルで現在の数値を確認します。価格は変動する可能性があり、記憶やフォーラムの投稿からハードコードすべきではない項目です。
- 長さとファイルサイズの制限。入力には最大長さとサイズの制限があります。ショート動画は通常簡単に制限内に収まりますが、より長いソースを含むバッチタスクはそうでないかもしれません。送信前に上限を確認してください。
- スループットと同時実行。並行して実行できるタスク数とレート制限の有無がキューの形を決定します。レート制限応答を受け取ったときにバックオフして再試行するようにクライアントを設計してください。
- タイムアウト動作。動画タスクは通常の HTTP リクエストより時間がかかる場合があります。推奨されるポーリング間隔とタスク保持期間を確認してください。
- パラメータの安定性。モデルの設定はオンライン契約の一部として扱ってください。統合時にドキュメントを読み、動作が予期しない場合は再確認してください。
良いスケーリングパターン:代表的なクリップを検証し、実際の実行時間とコストを測定し、その後控えめに外挿してバッファを追加します。価格と制限はコードではなく設定に置き、更新がデプロイなしで設定変更だけで済むようにします。
topaz-upscale/video 上の1つのクリップから始め、検証し、それからスケールしてください——信頼できるショート動画画質向上パイプラインへの最短経路です。