ReddRadar
Agent skill
tts-openai
Generate high-quality voiceover using OpenAI TTS API
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/tts-openai
SKILL.md
TTS (Text-to-Speech) Skill
Generate professional voiceover audio using OpenAI's TTS API.
Prerequisites
- OpenAI API key set as environment variable:
OPENAI_API_KEY curlinstalled (standard on most systems)
Available Voices
| Voice | Description | Best For |
|---|---|---|
| alloy | Neutral, balanced | General purpose |
| echo | Warm, conversational | Storytelling |
| fable | British accent, narrative | Documentaries |
| onyx | Deep, authoritative | News, serious topics |
| nova | Friendly, upbeat | Tutorials, explainers |
| shimmer | Soft, gentle | Meditation, ASMR |
Available Models
| Model | Quality | Speed | Cost |
|---|---|---|---|
| tts-1 | Standard | Fast | Lower |
| tts-1-hd | High-definition | Slower | Higher |
Generate Voiceover
Using curl (Recommended)
# Generate voiceover
curl https://api.openai.com/v1/audio/speech \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "tts-1-hd",
"input": "Your script text goes here. This will be converted to speech.",
"voice": "nova"
}' \
--output output/voiceover.mp3
For Long Scripts
Split into chunks if text is very long (max ~4000 characters per request):
# Generate part 1
curl https://api.openai.com/v1/audio/speech \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "tts-1-hd",
"input": "First part of the script...",
"voice": "nova"
}' \
--output output/vo_part1.mp3
# Generate part 2
curl https://api.openai.com/v1/audio/speech \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "tts-1-hd",
"input": "Second part of the script...",
"voice": "nova"
}' \
--output output/vo_part2.mp3
# Combine parts
ffmpeg -i "concat:output/vo_part1.mp3|output/vo_part2.mp3" \
-acodec copy output/voiceover_combined.mp3
Audio Post-Processing
Normalize Audio Levels
ffmpeg -i output/voiceover.mp3 \
-filter:a loudnorm=I=-16:TP=-1.5:LRA=11 \
output/voiceover_normalized.mp3
Add Background Music
# Mix voiceover with background music (music at 15% volume)
ffmpeg -i output/voiceover.mp3 -i assets/music/background.mp3 \
-filter_complex "[1:a]volume=0.15[bg];[0:a][bg]amix=inputs=2:duration=first" \
output/voiceover_with_music.mp3
Get Audio Duration
ffprobe -v error -show_entries format=duration \
-of default=noprint_wrappers=1:nokey=1 \
output/voiceover.mp3
Voice Selection Guide
| Content Type | Recommended Voice |
|---|---|
| Tech news | onyx (authoritative) |
| Tutorials | nova (friendly) |
| Storytelling | fable or echo |
| General | alloy |
| Calm/ASMR | shimmer |
Best Practices
- Clean the script: Remove stage directions, keep only spoken text
- Add punctuation: Periods and commas create natural pauses
- Use SSML-like formatting: "..." creates pauses in speech
- Test voices: Generate samples before full production
- Normalize audio: Ensure consistent levels
- Save originals: Keep unprocessed audio for re-editing
Cost Estimation
| Model | Cost per 1M chars | ~Cost per minute |
|---|---|---|
| tts-1 | $15.00 | ~$0.10 |
| tts-1-hd | $30.00 | ~$0.20 |
(Based on ~150 words/min, ~6 chars/word = ~900 chars/min)
Output Files
Save audio files to:
- Raw TTS:
output/voiceover_{project}.mp3 - Normalized:
output/voiceover_{project}_normalized.mp3 - With music:
output/voiceover_{project}_final.mp3
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?