venice-audio-speech
Generate speech from text via POST /audio/speech, and clone a voice via POST /audio/voices. Covers TTS models (Kokoro, Qwen 3, xAI, Inworld, Chatterbox, Orpheus, ElevenLabs Turbo, MiniMax, Gemini Flash, Gradium), voices per family, cloned-voice handles, output formats (mp3/opus/aac/flac/wav/pcm), streaming, prompt/emotion styling, temperature/top_p, and language hints.
veniceai · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add veniceai/skills --skill venice-audio-speech技能说明
name: venice-audio-speech description: Generate speech from text via POST /audio/speech, and clone a voice via POST /audio/voices. Covers TTS models (Kokoro, Qwen 3, xAI, Inworld, Chatterbox, Orpheus, ElevenLabs Turbo, MiniMax, Gemini Flash, Gradium), voices per family, cloned-voice handles, output formats (mp3/opus/aac/flac/wav/pcm), streaming, prompt/emotion styling, temperature/top_p, and language hints.
Venice TTS (/audio/speech)
POST /api/v1/audio/speech converts text to an audio stream or file. OpenAI-compatible — the OpenAI SDK's audio.speech.create() works as a drop-in.
Use when
- You want narration, voice replies, or UI audio from text.
- You need a specific voice family (ElevenLabs, Kokoro, xAI, Qwen 3, Orpheus, Chatterbox, MiniMax, Inworld, Gemini Flash).
- You want streaming audio returned sentence-by-sentence.
- You need style/emotion control on supported models.
For music generation (lyrics + instrumental), see venice-audio-music. For transcription (audio → text), see venice-audio-transcription.
Minimal request
curl https://api.venice.ai/api/v1/audio/speech \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "tts-xai-v1",
"voice": "eve",
"input": "Hello, welcome to Venice Voice.",
"response_format": "mp3",
"speed": 1.0,
"streaming": false
}' --output hello.mp3
Response is the raw audio (Content-Type matches response_format).
Request schema
| Field | Type | Default | Notes |
|---|---|---|---|
input | string | — | Required. Up to 4096 characters. |
model | enum | tts-kokoro (OpenAPI schema default) | See model list below. tts-xai-v1 is the recommended frontier default; pick the model that fits your voice + language needs. |
voice | string, ≤ 512 | model-specific (e.g. eve for tts-xai-v1) | Voice is model-specific — wrong combo = 400. See voice families. Also accepts a cloned-voice handle (vv_…) from POST /audio/voices, paired with the same model that created it. |
response_format | mp3 / opus / aac / flac / wav / pcm | mp3 | pcm returns 24 kHz signed-16 LE for pipelines. |
speed | number | 1.0 | Range 0.25–4.0. |
streaming | bool | false | true → streamed sentence-by-sentence as audio continues to generate. |
language | string | — | Optional hint. Accepted form depends on model (Qwen 3 = full names like English; xAI / ElevenLabs = ISO 639-1 like en; MiniMax = full names). Unsupported values silently ignored. |
prompt | string, ≤ 500 | — | Emotion / style cue. Only for models with supportsPromptParam (Qwen 3 currently). Examples: "Very happy.", "Sad and slow.". |
temperature | 0–2 | — | Sampling temperature. Only for models with supportsTemperatureParam (Qwen 3, Orpheus, Chatterbox HD). |
top_p | 0–1 | — | Only Qwen 3 currently. |
Models
| Model ID | Family | Highlights |
|---|---|---|
tts-xai-v1 | xAI | Recommended default. Conversational style, ISO 639-1 language hints. |
tts-kokoro | Kokoro | OpenAPI schema default. Multilingual, many voices across languages. |
tts-qwen3-0-6b / tts-qwen3-1-7b | Qwen 3 | Emotion control via prompt, temperature, top_p. |
tts-inworld-1-5-max | Inworld | Character-driven voices (Craig, Ashley, …). |
tts-chatterbox-hd | Chatterbox | HD voices (Aurora, Blade, …), temperature. |
tts-orpheus | Orpheus | Conversational (tara, leah, jess, leo, …), temperature. |
tts-elevenlabs-turbo-v2-5 | ElevenLabs Turbo | Rachel, Aria, Charlotte, Roger, … |
tts-minimax-speech-02-hd | MiniMax | WiseWoman, DeepVoiceMan, … Supports persistent voice cloning. |
tts-gemini-3-1-flash | Gemini Flash | Star-named voices (Achernar, Achird, Zephyr, …). |
tts-gradium-v1 | Gradium | Multilingual across en/de/es/fr/pt, where the voice picks the language (there is no separate language parameter). Proprietary upstream, so capabilities.private is false. |
Always inspect the entry for your model in GET /models?type=tts — model_spec.voices is the authoritative voice list. Per-model toggles like supportsPromptParam, supportsTemperatureParam, supportsTopPParam live on the internal model definitions but are not currently exposed on /models — treat the request schema below (instructions, temperature, top_p) as the support matrix.
Voice families (by prefix)
- Kokoro — lowercase + language/gender prefix:
af_*,am_*— American female / malebf_*,bm_*— British female / malezf_*,zm_*— Chineseff_*,hf_*,hm_*,if_*,im_*,jf_*,jm_*,pf_*,pm_*,ef_*,em_*— French, Hindi, Italian, Japanese, Portuguese, Spanish- Examples:
af_sky,af_bella,am_adam,bm_george,zf_xiaoxiao
- Qwen 3 —
Vivian,Serena,Ono_Anna,Sohee,Uncle_Fu,Dylan,Eric,Ryan,Aiden - xAI — 26 voices. Original five:
eve,ara,rex,sal,leo. Flagship multilingual set:altair,atlas,carina,castor,celeste,cosmo,helios,helix,iris,kepler,lumen,luna,lux,naksh,orion,perseus,rigel,sirius,ursa,zagan,zenith - Orpheus —
tara,leah,jess,mia,zoe,dan,zac - Inworld —
Craig,Ashley,Olivia,Sarah,Elizabeth,Priya,Alex,Edward,Theodore,Ronald,Mark,Hades,Luna,Pixie - Chatterbox —
Aurora,Britney,Siobhan,Vicky,Blade,Carl,Cliff,Richard,Rico - ElevenLabs Turbo —
Rachel,Aria,Laura,Charlotte,Alice,Matilda,Jessica,Lily,Roger,Charlie,George,Callum,River,Liam,Will,Chris,Brian,Daniel,Bill - MiniMax —
WiseWoman,FriendlyPerson,InspirationalGirl,CalmWoman,LivelyGirl,LovelyGirl,SweetGirl,ExuberantGirl,DeepVoiceMan,