# Orpheus TTS

> Orpheus TTS is a state-of-the-art, Llama-based Speech-LLM designed for high-quality, empathetic text-to-speech generation. This model has been finetuned to deliver human-level speech synthesis, achieving exceptional clarity, expressiveness, and real-time performances.


## Overview

- **Endpoint**: `https://fal.run/fal-ai/orpheus-tts`
- **Model ID**: `fal-ai/orpheus-tts`
- **Category**: text-to-speech
- **Kind**: inference
**Tags**: text to speech, voice synthesis, high-fidelity



## Pricing

- **Price**: $0.05 per 1000 characters

For more details, see [fal.ai pricing](https://fal.ai/pricing).

## API Information

This model can be used via our HTTP API or more conveniently via our client libraries.
See the input and output schema below, as well as the usage examples.


### Input Schema

The API accepts the following input parameters:


- **`text`** (`string`, _required_):
  The text to be converted to speech. You can additionally add the following emotive tags: <laugh>, <chuckle>, <sigh>, <cough>, <sniffle>, <groan>, <yawn>, <gasp>
  - Examples: "I just found a hidden treasure in the backyard! <gasp> Check it out!"

- **`voice`** (`VoiceEnum`, _optional_):
  Voice ID for the desired voice. Default value: `"tara"`
  - Default: `"tara"`
  - Options: `"tara"`, `"leah"`, `"jess"`, `"leo"`, `"dan"`, `"mia"`, `"zac"`, `"zoe"`
  - Examples: "tara"

- **`temperature`** (`float`, _optional_):
  Temperature for generation (higher = more creative). Default value: `0.7`
  - Default: `0.7`
  - Range: `0` to `2`

- **`repetition_penalty`** (`float`, _optional_):
  Repetition penalty (>= 1.1 required for stable generations). Default value: `1.2`
  - Default: `1.2`
  - Range: `1.1` to `2`



**Required Parameters Example**:

```json
{
  "text": "I just found a hidden treasure in the backyard! <gasp> Check it out!"
}
```

**Full Example**:

```json
{
  "text": "I just found a hidden treasure in the backyard! <gasp> Check it out!",
  "voice": "tara",
  "temperature": 0.7,
  "repetition_penalty": 1.2
}
```


### Output Schema

The API returns the following output format:

- **`audio`** (`File`, _required_):
  The generated speech audio
  - Examples: {"url":"https://v3.fal.media/files/kangaroo/RQ_pxc7oPdueYqWUqEbPE_tmpjnzvvzx_.wav"}



**Example Response**:

```json
{
  "audio": {
    "url": "https://v3.fal.media/files/kangaroo/RQ_pxc7oPdueYqWUqEbPE_tmpjnzvvzx_.wav"
  }
}
```


## Usage Examples

### cURL

```bash
curl --request POST \
  --url https://fal.run/fal-ai/orpheus-tts \
  --header "Authorization: Key $FAL_KEY" \
  --header "Content-Type: application/json" \
  --data '{
     "text": "I just found a hidden treasure in the backyard! <gasp> Check it out!"
   }'
```

### Python

Ensure you have the Python client installed:

```bash
pip install fal-client
```

Then use the API client to make requests:

```python
import fal_client

def on_queue_update(update):
    if isinstance(update, fal_client.InProgress):
        for log in update.logs:
           print(log["message"])

result = fal_client.subscribe(
    "fal-ai/orpheus-tts",
    arguments={
        "text": "I just found a hidden treasure in the backyard! <gasp> Check it out!"
    },
    with_logs=True,
    on_queue_update=on_queue_update,
)
print(result)
```

### JavaScript

Ensure you have the JavaScript client installed:

```bash
npm install --save @fal-ai/client
```

Then use the API client to make requests:

```javascript
import { fal } from "@fal-ai/client";

const result = await fal.subscribe("fal-ai/orpheus-tts", {
  input: {
    text: "I just found a hidden treasure in the backyard! <gasp> Check it out!"
  },
  logs: true,
  onQueueUpdate: (update) => {
    if (update.status === "IN_PROGRESS") {
      update.logs.map((log) => log.message).forEach(console.log);
    }
  },
});
console.log(result.data);
console.log(result.requestId);
```


## Additional Resources

### Documentation

- [Model Playground](https://fal.ai/models/fal-ai/orpheus-tts)
- [API Documentation](https://fal.ai/models/fal-ai/orpheus-tts/api)
- [OpenAPI Schema](https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=fal-ai/orpheus-tts)

### fal.ai Platform

- [Platform Documentation](https://docs.fal.ai)
- [Python Client](https://docs.fal.ai/clients/python)
- [JavaScript Client](https://docs.fal.ai/clients/javascript)