rw-generate-audio

bởi runwayml

Tạo âm thanh bằng API Runway thông qua các tập lệnh có thể chạy. Hỗ trợ TTS, hiệu ứng âm thanh, tách giọng nói, lồng tiếng và chuyển đổi giọng nói.

npx skills add https://github.com/runwayml/skills --skill rw-generate-audio

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

  1. command -v uv must succeed
  2. RUNWAYML_API_SECRET must be set, or pass --api-key

Audio Types

TypeDescriptionRequired Args
ttsText to speech--text
sfxSound effect generation--text
isolateIsolate voice from audio--audio-url
dubDub to another language--audio-url, --target-language
stsVoice conversion--audio-url

Parameters

ParamDescriptionDefault
--typeAudio type (required): tts, sfx, isolate, dub, sts--
--filenameOutput filename (required)--
--textText input (for tts and sfx)--
--audio-urlAudio URL or local path (for isolate, dub, sts)--
--voice-idVoice preset (for tts and sts, e.g. Maya, Noah, Leslie)Maya
--target-languageLanguage code (for dub, e.g. "es")--
--output-dirOutput directorycwd
--api-keyRunway API keyenv 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

runway-studio-skills
runwayml
Tạo video, hình ảnh và âm thanh chất lượng phòng thu bằng API Runway. Tất cả lệnh đều là các tập lệnh Python độc lập được chạy qua uv run từ thư mục gốc của kỹ năng.
official
runway-studio-skills
runwayml
Use this skill when the user wants to generate videos, images, or audio using the Runway API. Covers product ad videos, text-to-video,…
official
api-reference
runwayml
Tài liệu tham khảo đầy đủ về API công khai của Runway: các mô hình, điểm cuối, chi phí, giới hạn và loại
official
fetch-api-reference
runwayml
Truy xuất tài liệu tham khảo API Runway mới nhất từ docs.dev.runwayml.com và sử dụng nó làm nguồn chính thống trước khi thực hiện bất kỳ công việc tích hợp nào.
official
integrate-audio
runwayml
Giúp người dùng tích hợp các API âm thanh Runway (TTS, hiệu ứng âm thanh, tách giọng nói, lồng tiếng)
official
integrate-character-embed
runwayml
Giúp người dùng nhúng các cuộc gọi hình đại diện Runway Character vào ứng dụng React bằng SDK @runwayml/avatars-react
official
integrate-characters
runwayml
Giúp người dùng tạo Runway Characters (avatar GWM-1) và tích hợp các phiên hội thoại thời gian thực vào ứng dụng của họ.
official
integrate-documents
runwayml
Giúp người dùng thêm tài liệu cơ sở tri thức vào Runway Characters để có các cuộc trò chuyện theo lĩnh vực cụ thể
official