---
title: "Generate Batch Voices ≤500 total chars"
method: POST
path: "/v1/tts/batch"
---

# Generate Batch Voices ≤500 total chars

`POST /v1/tts/batch`

## Request

- Base URL: `https://voice.forgemesh.io`
- URL: `https://voice.forgemesh.io/v1/tts/batch`
- Auth: none declared

Batch text-to-speech: synthesize up to 20 separate text items in a single call, standard voices only, up to 500 total characters, returns JSON with base64 WAV audio plus duration and sample rate per item. Use it to: voice a list of short UI strings at once, generate audio for multiple notification templates, batch-produce voice lines for a menu or form, synthesize several short replies in one request. USDC on Base via x402.

## Request body

- object
  - `items` object[], required: Array of text items. Total text across all items must be <= 2000 chars; use /v1/tts/batch for <=500 total chars and /v1/tts/batch-long for 501-2000 total chars.
    - `text` string, required
    - `voice` 'M1' | 'M2' | 'M3' | 'M4' | 'M5' | 'F1' | 'F2' | 'F3' | 'F4' | 'F5': Standard voice: M1-M5 or F1-F5
    - `lang` 'en' | 'ko' | 'ja' | 'ar' | 'bg' | 'cs' | 'da' | 'de' | 'el' | 'es' | 'et' | 'fi' | 'fr' | 'hi' | 'hr' | 'hu' | 'id' | 'it' | 'lt' | 'lv' | 'nl' | 'pl' | 'pt' | 'ro' | 'ru' | 'sk' | 'sl' | 'sv' | 'tr' | 'uk' | 'vi': Language code; 31 languages supported
  - `defaults` object
    - `voice` 'M1' | 'M2' | 'M3' | 'M4' | 'M5' | 'F1' | 'F2' | 'F3' | 'F4' | 'F5': Standard voice: M1-M5 or F1-F5
    - `lang` 'en' | 'ko' | 'ja' | 'ar' | 'bg' | 'cs' | 'da' | 'de' | 'el' | 'es' | 'et' | 'fi' | 'fr' | 'hi' | 'hr' | 'hu' | 'id' | 'it' | 'lt' | 'lv' | 'nl' | 'pl' | 'pt' | 'ro' | 'ru' | 'sk' | 'sl' | 'sv' | 'tr' | 'uk' | 'vi': Language code; 31 languages supported

## Response `200`

Successful synthesis response

- object
  - `items` object[]
    - `audio_base64` string
    - `duration_s` number
    - `format` string
    - `sample_rate` integer

## Other responses

- `400`: Invalid request or wrong pricing bucket
- `402`: Payment Required

---

[API](https://skmtc.dev/forgemesh/apis/text-to-speech-voice-generation.md) · [All operations](https://skmtc.dev/forgemesh/apis/text-to-speech-voice-generation/llms.txt) · [OpenAPI document](https://skmtc.dev/forgemesh/apis/text-to-speech-voice-generation/revisions/e4ba35932ef4?raw)