GET
/v1/schemas/dashscope/audio/audio%2Fspeech
Accept:
Request body
7 properties · 3 required · 1 $defs| property | type | description | constraints |
|---|---|---|---|
| model* | string | enum | One of the available [TTS models](https://developers.openai.com/api/docs/guides/text-to-speech): `tts-1`, `tts-1-hd`, `gpt-4o-mini-tts`, or `gpt-4o-mini-tts-2025-12-15`. | |
| input* | string | The text to generate audio for. The maximum length is 4096 characters. | length ≤ 4096 |
| voice* | VoiceIdsShared | enum | object | The voice to use when generating the audio. Supported built-in voices are `alloy`, `ash`, `ballad`, `coral`, `echo`, `fable`, `onyx`, `nova`, `sage`, `shimmer`, `verse`, `marin`, and `cedar`. You may also provide a custom voice object with an `id`, for example… | |
| instructions | string | Control the voice of your generated audio with additional instructions. Does not work with `tts-1` or `tts-1-hd`. | length ≤ 4096 |
| response_format | enum | The format to audio in. Supported formats are `mp3`, `opus`, `aac`, `flac`, `wav`, and `pcm`. | mp3 | opus | aac | flac | wav | pcm · default: "mp3" |
| speed | number | The speed of the generated audio. Select a value from `0.25` to `4.0`. `1.0` is the default. | 0.25 ≤ n ≤ 4 · default: 1 |
| stream_format | enum | The format to stream the audio in. Supported formats are `sse` and `audio`. `sse` is not supported for `tts-1` or `tts-1-hd`. | sse | audio · default: "audio" |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"dashscope","endpointId":"audio/speech","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}