axonrouter-tts

name	axonrouter-tts
description	Text-to-speech via AxonRouter /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.

AxonRouter — Text-to-Speech

Requires AXONROUTER_URL (and AXONROUTER_KEY if auth enabled). See https://raw.githubusercontent.com/rickicode/axonrouter/refs/heads/main/skills/axonrouter/SKILL.md for setup.

Discover

# 1) List models
curl $AXONROUTER_URL/v1/models/tts | jq '.data[].id'
# 2) Per-model metadata (params, voicesUrl if voice-by-id)
curl "$AXONROUTER_URL/v1/models/info?id=el/eleven_multilingual_v2"
# 3) List voices (elevenlabs, edge-tts, deepgram, inworld, local-device). Optional ?lang=vi
curl "$AXONROUTER_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 $AXONROUTER_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 "$AXONROUTER_URL/v1/audio/speech" \
  -H "Authorization: Bearer $AXONROUTER_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.AXONROUTER_URL}/v1/audio/speech`, {
  method: "POST",
  headers: { "Authorization": `Bearer ${process.env.AXONROUTER_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()));

Python:

from openai import OpenAI
import os

client = OpenAI(base_url=f"{os.environ['AXONROUTER_URL']}/v1", api_key=os.environ["AXONROUTER_KEY"])
response = client.audio.speech.create(model="openai/tts-1", input="Hello world", voice="alloy")
response.stream_to_file("speech.mp3")

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