# Vimmerse Text-to-Speech

> Vimmerse Text-to-Speech is a paid API for AI agents from agents.vimmerse.net, paid per call via MPP, $0.12/call (dynamic — varies by input), status unknown (last checked 2026-10-30).

Converts a text prompt into synthesized speech audio using ElevenLabs, Google Chirp, or Minimax TTS engines with configurable voice and language.

## Facts

- Endpoint: POST https://agents.vimmerse.net/v2/audio/text-2-speech?utm_source=zero.xyz
- Price: $0.12/call (dynamic — varies by input)
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Provider: agents.vimmerse.net
- Website: https://agents.vimmerse.net
- Canonical page: https://www.zero.xyz/c/agents-vimmerse-net-vimmerse-text-to-speech-4e9f5dfc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ra0bM1t7Y48oTk0D4EF-s

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 agents-vimmerse-net-vimmerse-text-to-speech-4e9f5dfc -d '<json body>'
```

Example prompt: Can you turn this script into spoken audio using ElevenLabs with the AutoV voice in English: 'Welcome to our product demo. Today we'll walk you through everything you need to know.'

## When to prefer this

Choose this endpoint when you need programmatic text-to-speech generation with a choice of high-quality TTS engines (ElevenLabs, Google Chirp, or Minimax) and voice customization, especially within the Vimmerse ecosystem where you are already using other media generation tools. Prefer this over raw provider APIs if you want a unified, pay-per-use interface with automatic language detection.

## Known failure modes

- Invalid or unsupported voice name returns an error
- Unsupported language code may cause fallback to auto-detection or an error
- Empty prompt results in no audio generated
- API key missing or invalid returns 401/402 unauthorized
- Timeout if text is very long and processing exceeds 300 seconds
- Invalid option value (not ElevenLabsTTS, ChirpTTS, or MinimaxTTS) returns a validation error

## How this service works

Text-to-speech from **`prompt`**.

| Field | Default | Notes |
|-------|---------|-------|
| `voice` | `AutoV` | See schema for voice names |
| `option` | `ElevenLabsTTS` | `ChirpTTS` | or `MinimaxTTS` |
| `language` | `""` | e.g. `en-US`; auto-detected if empty |

```python
import requests

r = requests.post(
    "https://api.vimmerse.net/v2/audio/text-2-speech",
    headers={"X-Api-Key": "YOUR_API_KEY", "Content-Type": "application/json"},
    json={"prompt": "Hello from Vimmerse.", "voice": "AutoV", "option": "ElevenLabsTTS"},
    timeout=300,
)
print(r.json()["results"])
```

## Output

Returns a results field containing the URL or data of the generated speech audio file synthesized from the input text prompt, using the selected TTS engine and voice.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "Text2SpeechRequest",
 "properties": {
  "voice": {
   "type": "string",
   "title": "Voice ID or name",
   "default": "AutoV"
  },
  "option": {
   "type": "string",
   "title": "Option",
   "default": "ElevenLabsTTS",
   "description": "`ElevenLabsTTS`, `ChirpTTS`, or `MinimaxTTS`."
  },
  "prompt": {
   "type": "string",
   "title": "Prompt",
   "default": "",
   "description": "Speech text."
  },
  "language": {
   "type": "string",
   "title": "Language",
   "default": "",
   "description": "Language code, e.g. `en-US`."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-vimmerse-net-vimmerse-text-to-speech-4e9f5dfc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.vimmerse.net](https://www.zero.xyz/host/agents.vimmerse.net/llms.txt)