---
title: aura-1 · Cloudflare Workers AI docs
description: Aura is a context-aware text-to-speech (TTS) model that applies
  natural pacing, expressiveness, and fillers based on the context of the
  provided text. The quality of your text input directly impacts the naturalness
  of the audio output.
chatbotDeprioritize: false
source_url:
  html: https://developers.cloudflare.com/workers-ai/models/aura-1/
  md: https://developers.cloudflare.com/workers-ai/models/aura-1/index.md
---

![Deepgram logo](https://developers.cloudflare.com/_astro/deepgram.DVGPhlbc.svg)

# aura-1

Text-to-Speech • Deepgram

@cf/deepgram/aura-1

Aura is a context-aware text-to-speech (TTS) model that applies natural pacing, expressiveness, and fillers based on the context of the provided text. The quality of your text input directly impacts the naturalness of the audio output.

| Model Info | |
| - | - |
| Batch | Yes |
| Partner | Yes |
| Real-time | Yes |
| Unit Pricing | $0.015 per 1k characters |

## Usage

Worker

```ts
export default {
  async fetch(request, env, ctx): Promise<Response> {
      const resp = await env.AI.run("@cf/deepgram/aura-1", {
        "text":"Hello World!"
      }, {
        returnRawResponse: true
      });


      return resp;
  },
} satisfies ExportedHandler<Env>;
```

curl

```sh
curl --request POST   --url 'https://api.cloudflare.com/client/v4/accounts/{ACCOUNT_ID}/ai/run/@cf/deepgram/aura-1'   --header 'Authorization: Bearer {TOKEN}'   --header 'Content-Type: application/json'   --data '{
    "text":"Hello world!"
}'
```

## Parameters

\* indicates a required field

### Input

* `speaker` string default angus

  Speaker used to produce the audio.

* `encoding` string

  Encoding of the output audio.

* `container` string

  Container specifies the file format wrapper for the output audio. The available options depend on the encoding type..

* `text` string required

  The text content to be converted to speech

* `sample_rate` number

  Sample Rate specifies the sample rate for the output audio. Based on the encoding, different sample rates are supported. For some encodings, the sample rate is not configurable

* `bit_rate` number

  The bitrate of the audio in bits per second. Choose from predefined ranges or specific values based on the encoding type.

### Output

The binding returns a `ReadableStream` with the image in JPEG or PNG format (check the model's output schema).

## API Schemas

The following schemas are based on JSON Schema

* Input

  ```json
  {
      "type": "object",
      "properties": {
          "speaker": {
              "type": "string",
              "enum": [
                  "angus",
                  "asteria",
                  "arcas",
                  "orion",
                  "orpheus",
                  "athena",
                  "luna",
                  "zeus",
                  "perseus",
                  "helios",
                  "hera",
                  "stella"
              ],
              "default": "angus",
              "description": "Speaker used to produce the audio."
          },
          "encoding": {
              "type": "string",
              "enum": [
                  "linear16",
                  "flac",
                  "mulaw",
                  "alaw",
                  "mp3",
                  "opus",
                  "aac"
              ],
              "description": "Encoding of the output audio."
          },
          "container": {
              "type": "string",
              "enum": [
                  "none",
                  "wav",
                  "ogg"
              ],
              "description": "Container specifies the file format wrapper for the output audio. The available options depend on the encoding type.."
          },
          "text": {
              "type": "string",
              "description": "The text content to be converted to speech"
          },
          "sample_rate": {
              "type": "number",
              "description": "Sample Rate specifies the sample rate for the output audio. Based on the encoding, different sample rates are supported. For some encodings, the sample rate is not configurable"
          },
          "bit_rate": {
              "type": "number",
              "description": "The bitrate of the audio in bits per second. Choose from predefined ranges or specific values based on the encoding type."
          }
      },
      "required": [
          "text"
      ]
  }
  ```

* Output

  ```json
  {
      "type": "string",
      "contentType": "audio/mpeg",
      "format": "binary",
      "description": "The generated audio in MP3 format"
  }
  ```
