Skip to main content

cleya tts

Generate a voiceover clip from text via the OpenAI audio API (opt-in cloud; needs OPENAI_API_KEY)

Cost: network — OpenAI audio API (OPENAI_API_KEY)

cleya tts --text "Welcome to the show" --voice nova --output vo.mp3

Options

FlagWhat it does
--textThe text to speakrequired · string
--voiceVoice (alloy, echo, fable, onyx, nova, shimmer, …); default alloystring
--modelTTS model (default gpt-4o-mini-tts)string
--formatAudio format: mp3 (default), wav, opus, aac, flacstring
--speedSpeed 0.25–4.0 (default 1.0)string
--instructionsSteer delivery — tone/energy/pacing (e.g. 'Upbeat, warm, confident; punchy; not flat')string
--tonePreset delivery instructions (shortcut for --instructions)string · one of energetic, warm, calm, serious, excited
--outputOutput audio pathstring
--overwriteOverwrite output file if it existsboolean

Category: author — create media from specs (scene DSL, cards, titles, captions, voiceover, capture)

Generated from the toolkit

Generated from cleya capabilities, the toolkit's own manifest, so it cannot drift. Run cleya tts --help for the same information in your terminal.