Text to speech (tool speak): {text (<= 2000 chars), voice? (Sulafat, Charon, Kore, Achird, Erinome, Schedar), character? (id or slug, reads in its voice), energy? (calm|confident|energetic|hype), style?, name?, budgetUsd?}. Output mediaKey is a WAV.

post/api/speech

Request

  • Base URL: https://shapelessai.com
  • URL: https://shapelessai.com/api/speech
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://shapelessai.com/api/auth/mcp/authorize, token URL https://shapelessai.com/api/auth/mcp/token, scopes: write)

Request body

textstring required

What to say, exactly as it should be read. At most 2000 characters.

voicestring

A roster name or a character voice id. Default Charon.

energy'calm' | 'confident' | 'energetic' | 'hype'

How the read moves: calm (measured and reassuring - explainers, anything serious or reflective); confident (the default: brisk, warm, matter-of-fact - product and brand video); energetic (bright and driving - launches, feature reveals, anything with momentum); hype (creator-loud - short-form hooks, reaction and meme-adjacent posts). Default confident.

stylestring

Extra direction in plain words, e.g. "smile on the last line". Gemini voices only.

namestring

File name stem. Default: the voice name.

budgetUsdnumber

The most this call may spend, in USD (default 2, max 10). Held while the tool runs, released after.

Response

OK

toolstring required
outputunknown required
chargedUsdnumber required

Changes

No recorded changes to this operation across all 2 revisions of this API.