- name
- tts
- description
- Use this skill whenever the user wants to convert text to speech, generate audio from text, create voiceovers, or produce spoken audio files. Triggers include: any mention of 'text to speech', 'TTS', 'read aloud', 'voice synthesis', 'generate speech', 'voiceover', 'narration audio', 'speak this text', or requests to turn written content into an audio/MP3 file. Also use when the user wants to pick a voice, adjust speech emotion/style, change speech rate or pitch, or compare TTS providers (Azure, Volcengine, Edge). If the user asks to 'make an audio version' of any text, 'record' a script, or produce '.mp3' output from text, use this skill. Do NOT use for speech-to-text, audio transcription, music generation, or sound effects.
Text-to-Speech (TTS) via tts.102465.xyz
Convert text into spoken audio using a hosted TTS API that supports multiple providers, voices, emotions, and tuning parameters.
API Base URL
https://tts.102465.xyzAll endpoints are under the /api prefix.
Quick Reference
| Task | Endpoint | Method |
|---|---|---|
| Generate speech audio | /api/tts | POST or GET |
| List available voices | /api/voices?provider=<name> | GET |
| List available providers | /api/providers | GET |
Generating Speech
Two equivalent ways to call the TTS endpoint:
POST (recommended for longer text or programmatic use)
curl -X POST https://tts.102465.xyz/api/tts \
-H "Content-Type: application/json" \
-d '{"text":"你好世界","voice":"晓晓","emotion":"温柔","provider":"azure"}' \
--output output.mp3GET (convenient for short text or browser-playable links)
https://tts.102465.xyz/api/tts?text=你好世界&voice=晓晓&provider=azureThe response is an audio file (MP3). Save it with --output in curl, or open the GET URL directly in a browser to play.
Parameters
| Parameter | Description | Default |
|---|---|---|
text | Text to synthesize (required) | — |
voice | Voice name (Chinese label or English ID) | Provider default |
emotion | Emotion or speaking style (Azure only) | — |
rate | Speech rate adjustment, percentage (Azure/Edge) | 0 |
pitch | Pitch adjustment, percentage (Azure/Edge) | 0 |
provider | TTS backend: azure, volcengine, or edge | azure |
Providers at a Glance
- azure — Default provider. Richest feature set: many voices, emotion/style control, rate and pitch tuning.
- volcengine — Alternative Chinese-language voices including specialty voices (e.g. film narration).
- edge — Microsoft Edge TTS voices including regional dialect options (e.g. Liaoning dialect). Supports rate and pitch.
Choosing a Voice and Emotion
Before generating speech, query the available voices for a provider:
curl https://tts.102465.xyz/api/voices?provider=azureThis returns a JSON list of voices and, for Azure, their supported emotions/styles. Use the voice's Chinese label (e.g. 晓晓) or English ID in the voice parameter, and pick an emotion from the voice's supported list for the emotion parameter.
Workflow
- Clarify requirements — Ask the user what text they want spoken, in what language, and whether they have a preference for voice gender, style, or emotion.
- Pick a provider — Default to
azureunless the user needs a specialty voice from another provider. If unsure, query/api/providersand/api/voices?provider=<name>to browse options. - Generate the audio — Call
/api/ttswith the chosen parameters. For programmatic use, POST with JSON body; for a quick shareable link, construct a GET URL. - Deliver the result — If using curl/POST, save the MP3 to
/mnt/user-data/outputs/and present it to the user. If constructing a GET link, provide the URL so the user can play it in-browser.
Example GET URLs
Azure with emotion:
https://tts.102465.xyz/api/tts?text=今天天气真不错&provider=azure&voice=晓晓&emotion=温柔Volcengine specialty voice:
https://tts.102465.xyz/api/tts?text=在遥远的东方，有一个古老的传说&provider=volcengine&voice=影视男解说%20中英混Edge dialect voice:
https://tts.102465.xyz/api/tts?text=今天咱们唠唠嗑&provider=edge&voice=晓北%20辽宁%20女Tips
- URL-encode Chinese characters and spaces when constructing GET URLs (e.g.
%20for space). - The
emotionparameter only works with Azure. Other providers ignore it. rateandpitchare percentages — positive values speed up / raise pitch, negative values slow down / lower pitch. They work with Azure and Edge.- If the user doesn't specify a voice, omit the
voiceparameter to use the provider's default. - When generating audio files programmatically, save as
.mp3.