Skip to content
clusters: prooflayer · edgemarket · edgefinance · synthforge · mediakit · wordmint · webprobe · locale · comppoint · rollforge · bestiary · statline · matchpoint · retail · agentops · browserworkflow · modelrouter · compose
$ man text-to-speech

/text-to-speech

agentutility / synthforge / text-to-speech
PRICE / CALL
$0.05
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
synthforge
CATEGORY
ai
STATUS
● live
NAME
text-to-speech — generate a hosted audio url each time an updated script needs the same narrator
SYNOPSIS
POST https://x402.agentutility.ai/text-to-speech
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }
↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.
DESCRIPTION

Generate a hosted audio URL each time an updated script needs the same narrator. Send up to 4,000 characters with a voice, model, speed, and mp3, wav, opus, aac, or flac format; receive audio_url, file size, content type, and the settings used. Save the selected voice settings with your script to produce another narration in the same style. The default Kokoro route uses Morpheus primary with Venice fallback and fal.ai storage. Use it as a text-to-speech API, repeatable narration API, script-to-audio service, or accessibility read-aloud.

INPUT — request schema
propertytypedescriptionreq?
textstringText to synthesize, up to 4,000 characters.required
voicestringModel-specific voice ID. Default af_sky; onyx maps to the Kokoro am_onyx voice.optional
modelstringTTS model ID. Default tts-kokoro; the voice must be compatible with the selected model.optional
speednumberPlayback speed from 0.25 to 4. Default 1.optional
formatstringAudio format. Default mp3.
enum: mp3 · wav · opus · aac · flac
optional
OUTPUT — response shape
fieldtypedescription
audio_urlstringHosted URL for the generated audio file.
file_size_bytesintegerGenerated audio file size in bytes.
content_typestringMIME type of the hosted audio file.
formatstringAudio container returned.
voicestringVoice ID used for synthesis.
modelstringModel used for synthesis.
speednumberPlayback speed used for synthesis.
input_charsintegerCharacter count of the synthesized input.
sourcestringProvider that produced the audio.
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/text-to-speech \
  -H 'Content-Type: application/json' \
  -d '{ }'
first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.
EXAMPLE 2 · mcp
# Install the MCP package for this endpoint's cluster
npx -y @agentutility/mcp-<cluster>

# Required: EVM private key with USDC on Base
export X402_PRIVATE_KEY=0x...

# Then call the text-to-speech tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
tags
ttsspeechaudiovoiceai
env
VENICE_API_KEY · FAL_KEY
methods
POST
cluster
synthforge
price
$0.05 USDC per call
ADJACENT — other endpoints in synthforge
endpointdescriptionprice
voiceTurn written text into spoken audio you can drop straight into a player or app.$0.05
image-generate-proPremium text-to-image API for repeatable product, campaign, and design assets when a standard draft needs a selected model tier.$0.06
recraftGenerates SFW design and illustration images with Venice's recraft-v4 model on a dedicated endpoint.$0.06
seedreamGenerates SFW images with Venice's seedream-v4 model on a dedicated endpoint.$0.06
flux-2-proGenerates SFW images with Venice's flux-2-pro model on a dedicated endpoint.$0.04
qwen-imageGenerates SFW images with Venice's qwen-image model on a dedicated endpoint.$0.04
background-removeRemoves the background from a public image URL and returns the subject with alpha transparency.$0.08
background-removerRemoves the background from product, portrait, and object images, returning alpha PNG foreground cutouts with optional crop-to-bounding-b…$0.08
SEE ALSO
agentutility · synthforge · x402 · mcp · llms.txt · registry.json · bazaar.x402.org