voice-ai-tts

# Voice.ai Voices

## ✨ Features

- **9 Voice Personas** - Carefully curated voices for different use cases
- **11 Languages** - Multi-language synthesis with multilingual model
- **Streaming Mode** - Real-time audio output as it generates
- **Voice Design** - Customize with temperature and top_p parameters
- **OpenClaw Integration** - Works with OpenClaw's built-in TTS

---

## ⚙️ Configuration

Set your API key as an environment variable:

```bash
export VOICE_AI_API_KEY="your-api-key"
```

**Get your API key:** [Voice.ai Dashboard](https://voice.ai/dashboard)

---

## 📦 Installation

No install step is required. This skill bundles a Node.js CLI and SDK (no external npm dependencies).

## 🧩 Key Files

- [`scripts/tts.js`](scripts/tts.js) - CLI entrypoint
- [`voice-ai-tts-sdk.js`](voice-ai-tts-sdk.js) - Node.js SDK used by the CLI
- [`voices.json`](voices.json) - Voice definitions used by the CLI
- [`voice-ai-tts.yaml`](voice-ai-tts.yaml) - API specification
- [`package.json`](package.json) - Skill metadata for tooling

## Security Notes

See [`SECURITY.md`](SECURITY.md) for the full security and privacy overview.

This skill:
- Makes outbound HTTPS requests only to `https://dev.voice.ai`
- Reads local files: `voices.json`
- Writes audio output to the `--output` path (default `output.mp3`)
- Does not execute shell commands and does not modify system configuration files

## 🌐 API Endpoint

The SDK and spec use `https://dev.voice.ai`, which is the official Voice.ai production API domain.

---

## 🤖 OpenClaw Integration

OpenClaw can invoke the CLI script directly if your environment exposes `VOICE_AI_API_KEY`. Use the `/tts` commands as configured by your OpenClaw installation.

---

## 📝 Triggers

These chat commands work with OpenClaw:

| Command | Description |
|---------|-------------|
| `/tts <text>` | Generate speech with default voice |
| `/tts --voice ellie <text>` | Generate speech with specific voice |
| `/tts --stream <text>` | Generate with streamin...

# Voice.ai Voices

High-quality voice synthesis with 9 personas, 11 languages, and streaming using the Voice.ai API.

Requires Node.js 18+.

## Quick Start

```bash
# Set API key
export VOICE_AI_API_KEY="your-key-here"

# Generate speech
node scripts/tts.js --text "Hello world!" --voice ellie

# Streaming for long text
node scripts/tts.js --text "Once upon a time..." --voice lilith --stream
```

## Configuration

The CLI requires `VOICE_AI_API_KEY` to be set as an environment variable.

## API Endpoint

The SDK uses `https://dev.voice.ai`, which is the official Voice.ai production API domain.

## Voices

Voice definitions live in `voices.json`. Use the CLI with `--voice <name>`:

```
ellie, oliver, lilith, smooth, shadow, sakura, zenith, flora, commander
```

## Documentation

- `SKILL.md` for full usage and examples
- `voice-ai-tts.yaml` for the API spec
- `voice-ai-tts-sdk.js` for SDK usage

## Security

See `SECURITY.md` for a clear list of what the skill reads/writes locally and what endpoints it contacts.

## Links

- Voice.ai Dashboard: https://voice.ai/dashboard
- Voice.ai Docs: https://voice.ai/docs