Shorts voiceover（ショート動画音声ナレーション）
スクリプトを入力すると、アップロード準備完了のショート動画を出力します。テキストの長さからキャプションのタイミングを推測する他のツールとは異なり、このスキルは完成した音声トラックを文字起こしするため、すべてのキャプションが単語が話された瞬間に正確に表示されます。
使用するタイミング
- 「このスクリプト／これらのヒント／この記事をShort（またはReel、TikTok）にして」
- 「顔出しなしのショート動画を、音声とキャプション付きで作って」 「自分の声を使って」
- 「これらのスクリプトから5本のショート動画を作って」 → スクリプトファイルごとに1回実行します。
手順
-
MIRAGEA_API_KEYが設定されていることを確認します（絶対に表示しないでください）。音声：ユーザーのMirageaボイスID、またはユーザーの声のクリップの公開URLとその正確な言葉。export MIRAGEA_VOICE_ID=...を提案してください。ユーザーが所有している、または使用を許可されている音声のみをクローンします。 -
スクリプトを書きます：シーンごとに1段落、シーン間は空行、45～60秒のショート動画の場合120～170語程度。シーン1はフックで始めます。シーンの先頭に
@fileを付けると、その背景を指定できます。ナレーションをプロのように聞こえさせる3つの簡単なヒント @broll/desk.mp4 まず、柔らかい家具のある小さな部屋で録音しましょう。反響はノイズよりも修正が難しいです。 -
レンダリング：
python3 scripts/short.py tips.txt --voice VOICE_ID # グラデーション背景 python3 scripts/short.py tips.txt --media ./broll --music bed.mp3 # ユーザーの画像/クリップ＋音楽 -
出力されたJSONから
videoとsrtをユーザーに提供します。編集オプションを提案：シーンのテキストを変更して再実行。そのシーンのみ再ボイスが行われ、残りはキャッシュから取得されます。
自動で行われる処理
| ステップ | 方法 |
|---|---|
| 音声 | 各シーンはMirageaでボイス化。シーン間には0.18秒の息継ぎを挿入 |
| キャプションタイミング | 完成した音声トラックをMirageaで文字起こし。1～3単語の大文字キュー、画面下3分の1に表示 |
| 画像 | 9:16にクロップ、シーンごとにゆっくりズームイン/アウトを交互に適用 |
| クリップ | 9:16にクロップ、シーンの長さにループまたはトリミング、元の音声は除去 |
| メディアがない場合 | アニメーショングラデーション（4つのカラーパレット、回転） |
| 音楽 | ループ、音量30%、音声に合わせてサイドチェインダッキング |
| ラウドネス | -14 LUFS（統合）、-1 dBTP（Shorts/TikTok/Reelsのターゲット） |
| 再実行 | シーンごとの音声と文字起こしはキャッシュ。変更のないシーンは無料 |
オプション
| フラグ | デフォルト | 説明 |
|---|---|---|
--voice ID / --ref-url URL --ref-text TEXT | 環境変数 | 保存済みMirageaボイス、または公開クリップからのクローン |
--media DIR | なし | @file のないシーン用の画像/クリップ（ファイル名順） |
--music FILE | なし | バックグラウンドミュージック、自動ダッキング |
--lowercase | オフ | センテンスケースのキャプション |
--no-captions | オフ | キャプションをスキップ（文字起こし費用なし） |
--model | expressive | または standard |
-o FILE | SCRIPT.short.mp4 | 出力パス |
料金と制限
音声：文字数に応じて課金（150語のショート動画は約850文字）。キャプションタイミング：完成した音声の秒数×3ポイント（25秒で約75ポイント）。その後はキャッシュ。最新の料金は GET https://miragea.ai/v1/capabilities を参照。各シーンは2,000文字未満である必要があります。3分（YouTubeのShorts制限）を超えると警告が表示されます。
トラブルシューティング
media file not found→@以降のパスはスクリプトまたは--mediaフォルダからの相対パスです。No such filter: gradients→ ffmpegのバージョンが6.1より古いのでアップグレードするか、画像を指定して--mediaを渡してください。401キーが間違っています、402miragea.aiでチャージしてください、429待ってから再実行（キャッシュされたものは再請求されません）。
使用する音楽や映像は、権利のあるものだけを使用してください。実際のスクリプトとその出力例については examples/ を参照してください。