openai-tts
OpenAI Text-to-Speech API for high-quality speech synthesis. Use for generating natural-sounding audio from text with customizable voices and tones.
Install / Use
npx skills add benchflow-ai/skillsbench --skill openai-ttsInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AI & Machine LearningSupported Platforms
Our assessment of openai-tts
openai-tts scores 85/100 on our quality scale, 584th of 947 AI & Machine Learning skills we index.
Its SKILL.md is 3.7 KB long, well organised into 10 sections with 4 code examples: a solid amount of guidance for an agent.
With 1,813 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
- Our last check on 2026-11-04 found the source still online.
- It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 98/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-02. Automated pattern scan on 2026-10-02. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
openai-tts compared with similar skills
All 4 of these similar skills score higher than openai-tts; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| openai-tts (this skill)by benchflow-ai | 85 | 1.8k | 4mo ago | SKILL.md |
| claude-memby thedotmack | 100 | 117.6k | today | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| Understand-Anythingby Egonex-AI | 100 | 92.8k | 1d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
Frequently asked questions
- How do I install openai-tts?
- Run
npx skills add benchflow-ai/skillsbench --skill openai-tts. The install tabs above show the steps for each supported agent. - Which AI agents does openai-tts work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is openai-tts safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 98/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is openai-tts still maintained?
- The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
Skill content
View source on GitHubname: openai-tts description: "OpenAI Text-to-Speech API for high-quality speech synthesis. Use for generating natural-sounding audio from text with customizable voices and tones."
OpenAI Text-to-Speech
Generate high-quality spoken audio from text using OpenAI's TTS API.
Authentication
The API key is available as environment variable:
OPENAI_API_KEY
Models
gpt-4o-mini-tts- Newest, most reliable. Supports tone/style instructions.tts-1- Lower latency, lower qualitytts-1-hd- Higher quality, higher latency
Voice Options
Built-in voices (English optimized):
alloy,ash,ballad,coral,echo,fablenova,onyx,sage,shimmer,versemarin,cedar- Recommended for best quality
Note: tts-1 and tts-1-hd only support: alloy, ash, coral, echo, fable, onyx, nova, sage, shimmer.
Python Example
from pathlib import Path
from openai import OpenAI
client = OpenAI() # Uses OPENAI_API_KEY env var
# Basic usage
with client.audio.speech.with_streaming_response.create(
model="gpt-4o-mini-tts",
voice="coral",
input="Hello, world!",
) as response:
response.stream_to_file("output.mp3")
# With tone instructions (gpt-4o-mini-tts only)
with client.audio.speech.with_streaming_response.create(
model="gpt-4o-mini-tts",
voice="coral",
input="Today is a wonderful day!",
instructions="Speak in a cheerful and positive tone.",
) as response:
response.stream_to_file("output.mp3")
Handling Long Text
For long documents, split into chunks and concatenate:
from openai import OpenAI
from pydub import AudioSegment
import tempfile
import re
import os
client = OpenAI()
def chunk_text(text, max_chars=4000):
"""Split text into chunks at sentence boundaries."""
sentences = re.split(r'(?<=[.!?])\s+', text)
chunks = []
current_chunk = ""
for sentence in sentences:
if len(current_chunk) + len(sentence) < max_chars:
current_chunk += sentence + " "
else:
if current_chunk:
chunks.append(current_chunk.strip())
current_chunk = sentence + " "
if current_chunk:
chunks.append(current_chunk.strip())
return chunks
def text_to_audiobook(text, output_path):
"""Convert long text to audio file."""
chunks = chunk_text(text)
audio_segments = []
for chunk in chunks:
with tempfile.NamedTemporaryFile(suffix='.mp3', delete=False) as tmp:
tmp_path = tmp.name
with client.audio.speech.with_streaming_response.create(
model="gpt-4o-mini-tts",
voice="coral",
input=chunk,
) as response:
response.stream_to_file(tmp_path)
segment = AudioSegment.from_mp3(tmp_path)
audio_segments.append(segment)
os.unlink(tmp_path)
# Concatenate all segments
combined = audio_segments[0]
for segment in audio_segments[1:]:
combined += segment
combined.export(output_path, format="mp3")
Output Formats
mp3- Default, general useopus- Low latency streamingaac- Digital compression (YouTube, iOS)flac- Lossless compressionwav- Uncompressed, low latencypcm- Raw samples (24kHz, 16-bit)
with client.audio.speech.with_streaming_response.create(
model="gpt-4o-mini-tts",
voice="coral",
input="Hello!",
response_format="wav", # Specify format
) as response:
response.stream_to_file("output.wav")
Best Practices
- Use
marinorcedarvoices for best quality - Split text at sentence boundaries for long content
- Use
wavorpcmfor lowest latency - Add
instructionsparameter to control tone/style (gpt-4o-mini-tts only)
Related Skills
claude-mem
117.6kPersistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Understand-Anything
92.8kGraphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
