media-use

プラグインのインストール： このスキルが HyperFrames プラグイン内にある場合は、セットアップコマンドや鮮度確認コマンドを実行する前に、プラグインの実行ルールに従ってください。

HyperFrames のメディア

メディアは、台帳レコードとともにプロジェクトの assets/ 内のローカルファイルとして保存されます。レンダリング時に取得することはありません。次のコマンドで検索または作成できます。

npx hyperframes media-use resolve --type <type> --intent "<what you need>" --project <dir>

resolved <id> → <path> (<type>, <metadata>) という1行が出力されます。まず --candidates で再利用可能なアセットを一覧表示し、適合性は自分で判断してください。再利用、取り込み（--from）、採用については references/resolve.md を参照してください。

入手方法は2つ

必要なもの	HeyGen（最高品質）	無料、アカウント不要
音楽（bgm）	1万曲以上のカタログ	ローカルの MusicGen（audio/references/bgm.md）
効果音（sfx）		Openverse、オフラインで使えるバンドル済みの21種類
画像、アイコン	アセット検索、7万5千点以上	インストール済みの場合はローカルの FLUX（mflux）
ロゴ（logo）		theSVG、GitHub アバター、ファビコン。描き直しは不可
ナレーション（voice）	HeyGen の音声、音声クローン	npx hyperframes tts（デバイス上の Kokoro。Python 3.10 以降と pip install kokoro-onnx soundfile が必要）
話すプレゼンター	アバター動画（--type video）	汎用クリップ向けのローカル LTX（インストール済みの場合）
文字起こし		npx hyperframes transcribe（Parakeet または whisper）
切り抜き	heygen background-removal	npx hyperframes remove-background
色調、LUT、ルック		npx hyperframes media-treatment

ホストアプリ。 独自のメディアツールを提供するアプリ内では、まずそのツールを使用してください。HEYGEN_API_BASE が設定されている場合、HeyGen の費用はホストが負担します。heygen CLI やサインインを求めないでください。また、呼び出しが拒否された場合は、ホストのメッセージをそのまま伝えて終了してください。

HeyGen。 heygen CLI をインストールし、heygen auth login --oauth でサインインしてください。OAuth セッションではサブスクリプションクレジットの無料利用枠を使えます。API キー（--api-key）を使う場合は API クレジットが課金されます。npx hyperframes media-use resolve --doctor でセットアップを確認してください。リクエストに HeyGen が必要（プレゼンターやアバター、HeyGen の音声、カタログ音楽）で、heygen がインストールされていないかサインアウトしている場合は、利用方法を案内してください。インストールリンク、無料利用枠を使うための heygen auth login --oauth、またはクレジット用の API キーを案内します。その後、無料の方法を提案するか、返答を待ってください。resolve 以外にも、同じ CLI でテキストから動画を作成（heygen video-agent create）、録音トラックを使ったアバター動画を作成（heygen video create）、音声をクローン（heygen voice clone create）、吹き替え（heygen lipsync）、動画を翻訳（heygen video-translate）、長い動画から短いクリップを作成（heygen ai-clipping）できます。手順は references/operations.md を参照してください。

無料。 無料欄のすべてのツールはアカウント不要です。ローカルモデルは任意でインストールします（references/setup-providers.md）。heygen がない場合、音楽、画像、アイコンの resolve は失敗し、その旨を表示します。CC BY の音源にはクレジットを記載してください（audio/references/sfx.md）。--local-only を指定すると、すべてのネットワークプロバイダーをスキップします。

費用。 自分の判断で行う有料呼び出しは、実行前に確認してください（アバター動画も対象です）。依頼された呼び出しはそのまま実行してください。依頼者が生成方法を指定した場合は、--provider <name> でそのジェネレーターを固定します。

実写映像のルック

映像が暗い、平坦、またはくすんでいる、レトロ風や印刷物風にしたい、顔を隠したい、またはリビール演出が必要といったフィードバックは、メディア処理の意図を示しています。references/media-treatments.md を読んでください。実際の <img>／<video> を確認し、意図を1つ選んで、npx hyperframes media-treatment --capabilities --json から始め、続けて --capability <id> を実行してください。--all は使用しないでください。最終的な処理は npx hyperframes media-treatment で保存してください。対応している効果の代わりに CSS や SVG を使わないでください。また、露出や暖かみを表現するだけの .cube を生成しないでください。

1度だけ提案し、黙って追加しない

作品を制作またはレビューするときは、具体的な不足がないか一度確認してください（画面上のテキストにナレーションがない、アイコンの代わりに絵文字を使っている、プレースホルダー画像がある、無音のカットがある、音楽のない状態が10秒以上続く、色かぶりがあるなど）。見つかった場合は、具体的な修正案を1つの確認として提示してください。問題がなければ提案せず、「そのままにして」という希望を尊重してください。

参照先

タスク	参照先
解決、再利用、採用、取り込み、フラグ	references/resolve.md
グレーディング、LUT、grade-compare	references/grading.md
ナレーション、音楽、効果音、字幕、文字起こし	references/audio.md
メディアのカット、リフレーム、変換、HeyGen のレシピ	references/operations.md
処理、リアルタイムエフェクト、オーバーレイ、リビール	references/media-treatments.md
インストール、サインイン、プロバイダー、RAM の段階	references/setup-providers.md
配置済みトラックのフェード、ゲイン、ダッキング、オートメーション、エフェクト、バス	references/mixing.md
ローカルコマンド：グレーディング、切り抜き、ラウドネス、ビート	references/local.md
記憶された設定	references/memory.md