# rw-generate-audio

Generate audio using the Runway API via runnable scripts. Supports TTS, sound effects, voice isolation, dubbing, and voice conversion.

Skill by Runway. Category: Agent craft.

## Install

Project (for this project only):

```sh
npx skills add runwayml/skills --skill rw-generate-audio
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx skills add runwayml/skills --skill rw-generate-audio -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.
- Runs shell commands: Its steps run shell commands in your terminal.

## Security audits

- Gen Agent Trust Hub: Pass
- Socket: Pass
- Snyk: Pass
- ZeroLeaks: Pass

Installs: 301. Installs counted by skills.sh. [Open on skills.sh](https://www.skills.sh/runwayml/skills/rw-generate-audio)

## Source

[Open the source](https://github.com/runwayml/skills/tree/HEAD/skills/rw-generate-audio). Checked 2026-10-10. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

## SKILL.md

````markdown
---
name: rw-generate-audio
description: "Generate audio using the Runway API via runnable scripts. Supports TTS, sound effects, voice isolation, dubbing, and voice conversion."
user-invocable: true
allowed-tools: Read, Grep, Glob, Edit, Write, Bash(uv run *), Bash(command -v uv)
---

# 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

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

## Preflight

1. `command -v uv` must succeed
2. `RUNWAYML_API_SECRET` must 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:**
```bash
uv run scripts/generate_audio.py --type tts --text "Welcome to our product showcase" --filename "voiceover.mp3"
```

**Sound effect:**
```bash
uv run scripts/generate_audio.py --type sfx --text "Thunder rolling across a stormy sky" --filename "thunder.mp3"
```

**Voice isolation:**
```bash
uv run scripts/generate_audio.py --type isolate --audio-url "noisy-recording.mp3" --filename "clean-voice.mp3"
```

**Speech-to-speech (voice conversion):**
```bash
uv run scripts/generate_audio.py --type sts --audio-url "recording.mp3" --voice-id Noah --filename "converted.mp3"
```

**Dubbing:**
```bash
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
````

- Previous: [rw-check-org-details](https://syn4pse.dev/terminal/runway-check-org-details.md)
- Next: [revenuecat-experiments](https://syn4pse.dev/terminal/revenuecat-experiments.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
