rw-generate-audio

音声を生成

Runway API を使用して音声を直接生成します。テキスト読み上げ、効果音、音声分離、吹き替え、音声から音声への音声変換に対応しています。

重要： 出力ファイルがユーザーの想定する場所に保存されるよう、ユーザーの作業ディレクトリからスクリプトを実行してください。

使用方法

uv run scripts/generate_audio.py --type tts --text "Hello world" --filename "greeting.mp3" [--voice-id ID] [--api-key KEY]

事前確認

1. command -v uv が成功すること
2. RUNWAYML_API_SECRET が設定されているか、--api-key を渡すこと

音声の種類

種類	説明	必須引数
tts	テキスト読み上げ	--text
sfx	効果音の生成	--text
isolate	音声から声を分離	--audio-url
dub	別の言語に吹き替え	--audio-url、--target-language
sts	音声変換	--audio-url

パラメーター

パラメーター	説明	デフォルト
--type	音声の種類（必須）：tts、sfx、isolate、dub、sts	--
--filename	出力ファイル名（必須）	--
--text	テキスト入力（tts および sfx 用）	--
--audio-url	音声の URL またはローカルパス（isolate、dub、sts 用）	--
--voice-id	音声プリセット（tts および sts 用。例：Maya、Noah、Leslie）	Maya
--target-language	言語コード（dub 用。例："es"）	--
--output-dir	出力ディレクトリ	cwd
--api-key	Runway API キー	環境変数 RUNWAYML_API_SECRET

例

テキスト読み上げ：

uv run scripts/generate_audio.py --type tts --text "Welcome to our product showcase" --filename "voiceover.mp3"

効果音：

uv run scripts/generate_audio.py --type sfx --text "Thunder rolling across a stormy sky" --filename "thunder.mp3"

音声分離：

uv run scripts/generate_audio.py --type isolate --audio-url "noisy-recording.mp3" --filename "clean-voice.mp3"

音声から音声への変換（音声変換）：

uv run scripts/generate_audio.py --type sts --audio-url "recording.mp3" --voice-id Noah --filename "converted.mp3"

吹き替え：

uv run scripts/generate_audio.py --type dub --audio-url "english-narration.mp3" --target-language es --filename "spanish-dub.mp3"

出力

• スクリプトが結果をダウンロードし、指定したパスに保存します
• スクリプトは保存したファイルのフルパスを出力します