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#

text

https://tts.102465.xyz

All endpoints are under the /api prefix.

Quick Reference#

TaskEndpointMethodGenerate speech audio/api/ttsPOST or GETList available voices/api/voices?provider=<name>GETList available providers/api/providersGET

Generating Speech#

Two equivalent ways to call the TTS endpoint:

POST (recommended for longer text or programmatic use)#

bash

curl -X POST https://tts.102465.xyz/api/tts \
  -H "Content-Type: application/json" \
  -d '{"text":"你好世界","voice":"晓晓","emotion":"温柔","provider":"azure"}' \
  --output output.mp3

GET (convenient for short text or browser-playable links)#

text

https://tts.102465.xyz/api/tts?text=你好世界&voice=晓晓&provider=azure

The response is an audio file (MP3). Save it with --output in curl, or open the GET URL directly in a browser to play.

Parameters#

ParameterDescriptionDefaulttextText to synthesize ( required)—voiceVoice name (Chinese label or English ID)Provider defaultemotionEmotion or speaking style (Azure only)—rateSpeech rate adjustment, percentage (Azure/Edge)0pitchPitch adjustment, percentage (Azure/Edge)0providerTTS 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:

bash

curl https://tts.102465.xyz/api/voices?provider=azure

This 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#

1. 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.
2. Pick a provider — Default to azure unless the user needs a specialty voice from another provider. If unsure, query /api/providers and /api/voices?provider=<name> to browse options.
3. Generate the audio — Call /api/tts with the chosen parameters. For programmatic use, POST with JSON body; for a quick shareable link, construct a GET URL.
4. 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:

text

https://tts.102465.xyz/api/tts?text=今天天气真不错&provider=azure&voice=晓晓&emotion=温柔

Volcengine specialty voice:

text

https://tts.102465.xyz/api/tts?text=在遥远的东方，有一个古老的传说&provider=volcengine&voice=影视男解说%20中英混

Edge dialect voice:

text

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. %20 for space).
• The emotion parameter only works with Azure. Other providers ignore it.
• rate and pitch are 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 voice parameter to use the provider's default.
• When generating audio files programmatically, save as .mp3.