Skip to main content
Generate an MP3 speech sample from text. All arguments are optional: with none, it plays a default sample in the demo voice (lyra on Coda, Rime’s flagship model) — the fastest way to hear Rime. Choose a speaker and modelId from list_voices and get_voice_details. API key: Required — see Authentication. Samples consume credits like any other API request, so keep sample text short.

Parameters

ParameterTypeRequiredDefaultDescription
textstringNoA short demo lineText to synthesize (max 2,000 characters)
speakerstringNolyraVoice name from list_voices
modelIdstringNocodaModel ID: coda (flagship), mistv3, or arcana
languagestringNoSent as lang only if provided (e.g. eng, the value from get_voice_details). Omit to let Rime infer the language from the speaker
include_audiobooleanNofalseAlso return the audio as a standard MCP audio content block (base64), for hosts that play audio natively. Adds the audio to the model’s context

Returns

Audio is delivered three ways so it plays regardless of the host — an inline player in UI hosts, a short-lived play URL (structuredContent.audioUrl) for terminal hosts, and an optional audio content block. See Playing audio.

Example

Ask your assistant:
Play me a sample of the astra voice saying "Thanks for calling, how can I help?"