# openrouter-tts

openrouter-tts synthesizes speech audio from text using OpenRouter's speech API. Generates voiceovers, audiobook snippets, and audio files right from your prompt.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 327 installs · ★ 327 repo stars
- Author: OpenRouterTeam
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/OpenRouterTeam/skills/tree/HEAD/skills/openrouter-tts/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/openrouter-tts

## What it does

The skill equips the assistant to call OpenRouter's `POST /api/v1/audio/speech` endpoint using `curl` or OpenAI-compatible client libraries. Successful calls return raw binary audio rather than a JSON payload, so the agent writes the bytes directly to a media file.

An `OPENROUTER_API_KEY` environment variable is mandatory. The default format returned by the endpoint is uncompressed `pcm`, which will fail to play if saved under a `.mp3` extension. Setting `response_format` to `mp3` explicitly is required for standard media players.

Voice names are provider-specific. OpenAI models accept identifiers like `alloy` or `nova`, whereas engines like Voxtral or Kokoro require their own custom tags. The skill also handles model discovery by querying the models endpoint with speech modality filters.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add OpenRouterTeam/skills --skill openrouter-tts -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/openrouter-tts/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/openrouter-tts/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add OpenRouterTeam/skills --skill openrouter-tts -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/openrouter-tts/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add OpenRouterTeam/skills --skill openrouter-tts -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/openrouter-tts/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install OpenRouterTeam/skills skills/openrouter-tts
```

2. **Manually: put the files in place**
- File: `.github/skills/openrouter-tts/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add OpenRouterTeam/skills --skill openrouter-tts -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/OpenRouterTeam/skills --path skills/openrouter-tts
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/openrouter-tts/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add OpenRouterTeam/skills --skill openrouter-tts -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/OpenRouterTeam/skills/tree/HEAD/skills/openrouter-tts/SKILL.md

## When to use it
- Convert article drafts or scripts into playable mp3 audio
- Query OpenRouter for speech models and their supported voice names
- Adjust voice tone and pacing via OpenAI provider options
- Export raw pcm audio streams for custom processing pipelines

## Example prompts
- Convert script.txt into an mp3 file using openai/gpt-4o-mini-tts-2025-12-15 with the alloy voice
- List all TTS models and supported voices available on OpenRouter
- Generate an audio clip with a slow, warm tone using provider instructions

## Similar
- [edge-tts](https://affpapa.org/en/nevibecode/skills/edge-tts.md) — skill · 9000 installs
- [speech](https://affpapa.org/en/nevibecode/skills/speech.md) — skill · 3900 installs
- [volcengine-doubao-speech-tts](https://affpapa.org/en/nevibecode/skills/volcengine-doubao-speech-tts.md) — skill · 134 installs
- [tts-voiceover](https://affpapa.org/en/nevibecode/skills/tts-voiceover.md) — skill · ★ 1627 repo stars
- [qianwen-audio-tts](https://affpapa.org/en/nevibecode/skills/qianwen-audio-tts.md) — skill · 6200 installs
- [byteplus-seed-speech-tts](https://affpapa.org/en/nevibecode/skills/byteplus-seed-speech-tts.md) — skill · 128 installs

From the same set: [openrouterteam/skills](https://affpapa.org/en/nevibecode/by/openrouterteam/skills.md) — 16 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
