# Orpheus TTS

Generate speech, music and audio with Orpheus TTS from fal through one Spiral API key. It runs in the background and returns audio. Pay as you go, with no subscription.

- Provider: fal
- Category: Audio
- Runs: In the background
- Returns: audio
- Tool id: `fal` / `fal-ai/orpheus-tts`
- Page: https://spiral.ai/tools/fal/fal-ai/orpheus-tts

## Pricing

Each item in `text` adds $0.065.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 30 minutes
- Longest run, end to end: 255 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `text` (required) | text |  | — | The text to be converted to speech. You can additionally add the following emotive tags: <laugh>, <chuckle>, <sigh>, <cough>, <sniffle>, <groan>, <yawn>, <gasp> |
| `voice` | one of | tara, leah, jess, leo, dan, mia, zac, zoe | tara | Voice ID for the desired voice. |
| `temperature` | number | 0 to 2 | 0.7 | Temperature for generation (higher = more creative). |
| `repetition_penalty` | number | 1.1 to 2 | 1.2 | Repetition penalty (>= 1.1 required for stable generations). |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "fal-ai/orpheus-tts",
    "input": {
      "text": "I just found a hidden treasure in the backyard! <gasp> Check it out!"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=fal&model=fal-ai%2Forpheus-tts

## Common questions

### Orpheus TTS

**How much does Orpheus TTS cost?**

Each item in `text` adds $0.065. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use Orpheus TTS through an API?**

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "fal-ai/orpheus-tts"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with fal to use Orpheus TTS?**

No. Spiral runs it on its own fal account and charges your Spiral balance.

**Can my AI agent use Orpheus TTS?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

