Description
Generate audio using the Runway API via runnable scripts. Supports TTS, sound effects, voice isolation, dubbing, and voice conversion.
SKILL.md
Generate 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
More skills from the skills repository
View all 17 skillsrw-api-reference
look up Runway API reference
Apr 8AI InfrastructureAPI DevelopmentReferenceVideorw-check-compatibility
verify codebase compatibility with the Runway API
Apr 8API DevelopmentRunwayrw-check-org-details
query Runway API for organization details
Apr 8OperationsReportingRunwayrw-fetch-api-reference
retrieve Runway API reference
Apr 8API DevelopmentDocumentationResearchRunwayrw-generate-image
generate images with Runway API
Apr 17AI InfrastructureCreativeImage GenerationRunwayrw-generate-video
generate videos with Runway API
Apr 17AI InfrastructureCreativeRunwayVideo
More from Runway
View publisherrw-integrate-audio
integrate Runway audio APIs
skills
Apr 8API DevelopmentAudioCreativeRunway +1rw-integrate-character-embed
embed Runway characters in React apps
skills
Apr 8API DevelopmentFrontendReactRunway +1rw-integrate-characters
integrate Runway conversational characters
skills
Apr 8API DevelopmentAudioCreativeRunwayrw-integrate-documents
add documents to Runway Characters
skills
Apr 8AgentsAI ContextDocumentsKnowledge Management +1rw-integrate-image
integrate Runway image generation APIs
skills
Apr 8API DevelopmentCreativeImage GenerationRunway