$ man text-to-speech
/text-to-speech
PRICE / CALL
$0.05
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
synthforgeCATEGORY
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
| property | type | description | req? |
|---|---|---|---|
| text | string | Text to synthesize, up to 4,000 characters. | required |
| voice | string | Model-specific voice ID. Default af_sky; onyx maps to the Kokoro am_onyx voice. | optional |
| model | string | TTS model ID. Default tts-kokoro; the voice must be compatible with the selected model. | optional |
| speed | number | Playback speed from 0.25 to 4. Default 1. | optional |
| format | string | Audio format. Default mp3. enum: mp3 · wav · opus · aac · flac | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| audio_url | string | Hosted URL for the generated audio file. |
| file_size_bytes | integer | Generated audio file size in bytes. |
| content_type | string | MIME type of the hosted audio file. |
| format | string | Audio container returned. |
| voice | string | Voice ID used for synthesis. |
| model | string | Model used for synthesis. |
| speed | number | Playback speed used for synthesis. |
| input_chars | integer | Character count of the synthesized input. |
| source | string | Provider 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
| endpoint | description | price |
|---|---|---|
| voice | Turn written text into spoken audio you can drop straight into a player or app. | $0.05 |
| image-generate-pro | Premium text-to-image API for repeatable product, campaign, and design assets when a standard draft needs a selected model tier. | $0.06 |
| recraft | Generates SFW design and illustration images with Venice's recraft-v4 model on a dedicated endpoint. | $0.06 |
| seedream | Generates SFW images with Venice's seedream-v4 model on a dedicated endpoint. | $0.06 |
| flux-2-pro | Generates SFW images with Venice's flux-2-pro model on a dedicated endpoint. | $0.04 |
| qwen-image | Generates SFW images with Venice's qwen-image model on a dedicated endpoint. | $0.04 |
| background-remove | Removes the background from a public image URL and returns the subject with alpha transparency. | $0.08 |
| background-remover | Removes the background from product, portrait, and object images, returning alpha PNG foreground cutouts with optional crop-to-bounding-b… | $0.08 |
SEE ALSO