# ForgeMesh Voice Text-to-Speech API

> ForgeMesh Voice Text-to-Speech API is a paid API for AI agents from voice.forgemesh.io, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-13).

Converts text to spoken audio in multiple languages using persona voices, returning an audio file in OpenAI-compatible format via pay-per-call x402 micropayments.

## Facts

- Endpoint: POST https://voice.forgemesh.io/v1/audio/speech
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forgemesh-voice-text-to-speech-api-af145fa5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Zr0dXfiXxdRMY8oX5MOtu

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability forgemesh-voice-text-to-speech-api-af145fa5 -d '<json body>'
```

Example prompt: Read this paragraph aloud using a calm female persona voice and give me the audio as a WAV file: 'Welcome to ForgeMesh, where your AI agent finally has a voice worth hearing.'

## When to prefer this

Choose this endpoint when you need a pay-per-call, no-subscription TTS API that is OpenAI speech API-compatible, supports persona voices, covers 31 languages, and accepts x402 USDC micropayments — ideal for AI agents, serverless apps, or any workflow where you want to pay only per synthesis call without managing API keys or subscriptions.

## Known failure modes

- Payment not included or invalid x402 USDC payment — returns 402 Payment Required
- Unsupported response_format value (not wav, flac, or ogg) — returns 400 Bad Request
- Empty or missing input text — returns 400 Bad Request
- Unsupported or unknown voice name — returns 400 or falls back to default voice
- Service unavailable or overloaded — returns 503

## How this service works

OpenAI-compatible text-to-speech endpoint (input, voice, response_format) for drop-in use with code already built against the OpenAI TTS API, 1 of 10 standard voices, up to 500 characters, WAV/FLAC/OGG output. Use it to: swap OpenAI TTS calls for a pay-per-call x402 alternative, generate speech from an existing OpenAI-style client, avoid API-key management for short text-to-audio requests. USDC on Base.

## Output

An audio file (WAV, FLAC, or OGG) containing the synthesized speech of the input text, returned as a binary audio response with the appropriate content-type header (e.g. audio/wav). The response is OpenAI-compatible.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "string",
   "maxLength": 2000,
   "minLength": 1,
   "description": "OpenAI-compatible text input to synthesize, max 2000 characters"
  },
  "model": {
   "type": "string",
   "description": "Ignored — always uses ForgeMesh Voice"
  },
  "voice": {
   "enum": [
    "M1",
    "M2",
    "M3",
    "M4",
    "M5",
    "F1",
    "F2",
    "F3",
    "F4",
    "F5"
   ],
   "type": "string",
   "description": "Standard voice: M1-M5 or F1-F5"
  },
  "response_format": {
   "enum": [
    "wav",
    "flac",
    "ogg"
   ],
   "type": "string",
   "description": "Requested audio format"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "description": "OpenAI-compatible inline speech audio response",
  "content_type": "audio/wav"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemesh-voice-text-to-speech-api-af145fa5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from voice.forgemesh.io](https://www.zero.xyz/host/voice.forgemesh.io/llms.txt)