Agent Skills › decolua/9router › 9router-tts

9router-tts

GitHub

通过9Router统一接口调用OpenAI、ElevenLabs等TTS服务，将文本转换为语音。支持查询模型与声音列表，生成MP3或Base64音频，适用于旁白、朗读及语音合成场景。

skills/9router-tts/SKILL.md decolua/9router

Trigger Scenarios

用户要求将文本转换为语音需要生成音频文件或旁白请求朗读内容

Install

npx skills add decolua/9router --skill 9router-tts -g -y

More Options

Use without installing

npx skills use decolua/9router@9router-tts

指定 Agent (Claude Code)

npx skills add decolua/9router --skill 9router-tts -a claude-code -g -y

安装 repo 全部 skill

npx skills add decolua/9router --all -g -y

预览 repo 内 skill

npx skills add decolua/9router --list

SKILL.md

Frontmatter

{
    "name": "9router-tts",
    "description": "Text-to-speech via 9Router \/v1\/audio\/speech using OpenAI \/ ElevenLabs \/ Deepgram \/ Edge TTS \/ Google TTS \/ Hyperbolic \/ Inworld voices. Use when the user wants to convert text to speech, generate audio, voiceover, narrate, or read text aloud."
}

9Router — Text-to-Speech

Requires NINEROUTER_URL (and NINEROUTER_KEY if auth enabled). See https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router/SKILL.md for setup.

Discover

# 1) List models
curl $NINEROUTER_URL/v1/models/tts | jq '.data[].id'
# 2) Per-model metadata (params, voicesUrl if voice-by-id)
curl "$NINEROUTER_URL/v1/models/info?id=el/eleven_multilingual_v2"
# 3) List voices (elevenlabs, edge-tts, deepgram, inworld, local-device). Optional ?lang=vi
curl "$NINEROUTER_URL/v1/audio/voices?provider=edge-tts&lang=vi" | jq '.data[].model'

model field in /v1/audio/speech = voice ID directly (e.g. edge-tts/vi-VN-HoaiMyNeural, el/<voice_id>, or openai/tts-1 model+default voice).

Endpoint

POST $NINEROUTER_URL/v1/audio/speech

Field	Required	Notes
`model`	yes	voice ID from `/v1/models/tts`
`input`	yes	text to speak

Query ?response_format=mp3 (default, raw bytes) or ?response_format=json ({audio: base64, format}).

Examples

Save MP3:

curl -X POST "$NINEROUTER_URL/v1/audio/speech" \
  -H "Authorization: Bearer $NINEROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"openai/tts-1","input":"Hello world"}' \
  --output speech.mp3

JS (save file):

import { writeFile } from "node:fs/promises";
const r = await fetch(`${process.env.NINEROUTER_URL}/v1/audio/speech`, {
  method: "POST",
  headers: { "Authorization": `Bearer ${process.env.NINEROUTER_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ model: "el/eleven_multilingual_v2", input: "Xin chào" }),
});
await writeFile("speech.mp3", Buffer.from(await r.arrayBuffer()));

Response shape

Default → raw audio bytes (Content-Type audio/mp3).

?response_format=json:

{ "audio": "SUQzBAAAA...", "format": "mp3" }

Provider quirks (model format)

Provider	`model` format	Notes
`openai`	`tts-1/alloy` (model/voice) or just voice	Default model `gpt-4o-mini-tts`
`elevenlabs`	`<model_id>/<voice_id>` or `<voice_id>`	Default model `eleven_flash_v2_5`; list voices in Dashboard
`openrouter`	`openai/gpt-4o-mini-tts/alloy`	Streamed via chat-completions audio modality
`edge-tts`	voice id e.g. `vi-VN-HoaiMyNeural`	noAuth; default `vi-VN-HoaiMyNeural`
`google-tts`	language code e.g. `en`, `vi`	noAuth
`local-device`	OS voice name (`say -v ?` / SAPI)	noAuth; needs `ffmpeg`
`deepgram`	`aura-asteria-en` etc	Token auth
`nvidia`, `inworld`, `cartesia`, `playht`	`model/voice`	Provider-specific auth header
`coqui`, `tortoise`	speaker / voice id	Localhost noAuth
`hyperbolic`	model id	Body = `{text}` only