rw-generate-audiobởi runwayml
Generate audio using the Runway API via runnable scripts. Supports TTS, sound effects, voice isolation, dubbing, and voice conversion.
npx skills add https://github.com/runwayml/skills --skill rw-generate-audioGenerate Audio
Generate audio directly using the Runway API. Supports text-to-speech, sound effects, voice isolation, dubbing, and speech-to-speech voice conversion.
IMPORTANT: Run scripts from the user's working directory so output files are saved where the user expects.
Usage
uv run scripts/generate_audio.py --type tts --text "Hello world" --filename "greeting.mp3" [--voice-id ID] [--api-key KEY]
Preflight
command -v uvmust succeedRUNWAYML_API_SECRETmust be set, or pass--api-key
Audio Types
| Type | Description | Required Args |
|---|---|---|
tts | Text to speech | --text |
sfx | Sound effect generation | --text |
isolate | Isolate voice from audio | --audio-url |
dub | Dub to another language | --audio-url, --target-language |
sts | Voice conversion | --audio-url |
Parameters
| Param | Description | Default |
|---|---|---|
--type | Audio type (required): tts, sfx, isolate, dub, sts | -- |
--filename | Output filename (required) | -- |
--text | Text input (for tts and sfx) | -- |
--audio-url | Audio URL or local path (for isolate, dub, sts) | -- |
--voice-id | Voice preset (for tts and sts, e.g. Maya, Noah, Leslie) | Maya |
--target-language | Language code (for dub, e.g. "es") | -- |
--output-dir | Output directory | cwd |
--api-key | Runway API key | env RUNWAYML_API_SECRET |
Examples
Text-to-speech:
uv run scripts/generate_audio.py --type tts --text "Welcome to our product showcase" --filename "voiceover.mp3"
Sound effect:
uv run scripts/generate_audio.py --type sfx --text "Thunder rolling across a stormy sky" --filename "thunder.mp3"
Voice isolation:
uv run scripts/generate_audio.py --type isolate --audio-url "noisy-recording.mp3" --filename "clean-voice.mp3"
Speech-to-speech (voice conversion):
uv run scripts/generate_audio.py --type sts --audio-url "recording.mp3" --voice-id Noah --filename "converted.mp3"
Dubbing:
uv run scripts/generate_audio.py --type dub --audio-url "english-narration.mp3" --target-language es --filename "spanish-dub.mp3"
Output
- The script downloads the result and saves it to the specified path
- Script outputs the full path to the saved file
Thêm skills từ runwayml
recipe-full-setup
by runwayml
Complete Runway API setup: check compatibility, configure API key, and integrate generation endpoints
integrate-character-embed
by runwayml
Help users embed Runway Character avatar calls in React apps using the @runwayml/avatars-react SDK
integrate-characters
by runwayml
Help users create Runway Characters (GWM-1 avatars) and integrate real-time conversational sessions into their apps
integrate-documents
by runwayml
Help users add knowledge base documents to Runway Characters for domain-specific conversations
integrate-image
by runwayml
Help users integrate Runway image generation APIs (text-to-image with reference images)
integrate-uploads
by runwayml
Help users upload local files to Runway for use as inputs to generation models
integrate-video
by runwayml
Help users integrate Runway video generation APIs (text-to-video, image-to-video, video-to-video)
runway-studio-skills
by runwayml
Generate studio-quality videos, images, and audio using the Runway API. All commands are standalone Python scripts run via uv run from the skill root directory.