> ## Documentation Index
> Fetch the complete documentation index at: https://docs.suonora.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Welcome to Suonora - High-quality text-to-speech API for natural-sounding voice synthesis

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/quickstart">
    Get started with Suonora in minutes. Learn how to generate your first audio
    using our API.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/introduction">
    Explore our comprehensive API documentation, including endpoints,
    authentication, and examples.
  </Card>

  <Card title="Voice Gallery" icon="microphone" href="/essentials/voices">
    Browse our collection of natural-sounding voices in multiple languages and
    styles.
  </Card>

  <Card title="Account Management" icon="wallet" href="/essentials/balance">
    Learn about account balance and usage tracking.
  </Card>
</CardGroup>

## What is Suonora?

Suonora is a powerful text-to-speech API that converts written text into natural-sounding speech. Our technology uses advanced AI models to generate high-quality, human-like voices in multiple languages.

### Key Features

<CardGroup cols={3}>
  <Card icon="waveform">
    <h3>High-Quality Audio</h3>

    <p>
      Generate crystal-clear, natural-sounding speech with our advanced AI
      models.
    </p>
  </Card>

  <Card icon="globe">
    <h3>Multiple Languages</h3>
    <p>Support for various languages and accents to meet your global needs.</p>
  </Card>

  <Card icon="sliders">
    <h3>Voice Customization</h3>
    <p>Adjust voice parameters like style, emotion, and speaking rate.</p>
  </Card>

  <Card icon="bolt">
    <h3>Real-Time Streaming</h3>
    <p>Stream audio in real-time for low-latency applications.</p>
  </Card>

  <Card icon="code">
    <h3>Easy Integration</h3>
    <p>Simple REST API with SDK support for Node.js.</p>
  </Card>

  <Card icon="wallet">
    <h3>Usage Tracking</h3>
    <p>Monitor your API usage and manage your account balance.</p>
  </Card>
</CardGroup>

## What's in the Documentation?

Our documentation is organized into several sections to help you get the most out of Suonora:

### Guides

* **Quick Start**: Get up and running quickly with our step-by-step guide
* **Essentials**: Learn about core features and best practices
  * Models: Overview of available AI models
  * API Responses: Understanding API responses and error handling
  * Balance: Managing your account and usage
  * Voices: Exploring available voices and their features

### API Reference

* **Introduction**: API overview, authentication, and base URL
* **Endpoints**: Detailed documentation for each API endpoint
  * Speech API: Generate high-quality speech
  * Streaming API: Real-time audio streaming
  * Voices API: List and explore available voices
  * Balance API: Check account balance and usage

## Getting Started

<Steps>
  <Step title="Create an Account">
    Sign up for a Suonora account at [suonora.com](https://suonora.com) to get
    your API key.
  </Step>

  <Step title="Choose Your Integration">
    Use our Node.js SDK or make direct API calls using your preferred
    programming language.
  </Step>

  <Step title="Generate Your First Audio">
    Follow our [Quick Start Guide](/quickstart) to create your first
    text-to-speech audio.
  </Step>

  <Step title="Explore Features">
    Try different voices, languages, and customization options to find what
    works best for your needs.
  </Step>
</Steps>

## Need Help?

* **Support**: Contact our support team at [support@suonora.com](mailto:support@suonora.com)
* **Status**: Check our [status page](https://status.suonora.com) for service updates

<Note>
  For the best experience, we recommend using our official Node.js SDK. It
  handles authentication, retries, and error handling automatically.
</Note>

***

## What this documentation covers

* Base URL for all API requests
* Authentication using your API key
* Concurrency limits by subscription plan
* Endpoints for voices, balance, and speech generation
* Required parameters and usage examples
* Response formats and common error codes

***

## Base URL

```http
https://api.suonora.com/v1
```

Use this as the base for all requests to the Suonora API.

***

## Authentication

Every request must include your API key in the `Authorization` header:

```http
Authorization: Bearer YOUR_API_KEY
```

You can generate and manage your API keys in the [Suonora Dashboard](https://suonora.com/).

***

## Concurrency Limits

Each plan defines how many TTS jobs you can run at the same time. If your limit is reached, new requests are queued automatically.

| Plan               | Concurrent Jobs |
| ------------------ | --------------- |
| Personal (\$5/mo)  | 6               |
| Superior (\$10/mo) | 10              |
| Pro (\$29/mo)      | 20              |

If the queue is full, you may receive:

* `429 Too Many Requests`
* `503 Service Unavailable`

Use exponential backoff when retrying.

***

## Example Request

```bash
curl -X GET "https://api.suonora.com/v1/voices/list" \
     -H "Authorization: Bearer YOUR_API_KEY"
```

***

## Example Response

```json response.json
{
  "success": true,
  "voices": [
    {
      "id": "axel",
      "name": "Axel",
      "gender": "Male",
      "locale": "de-DE",
      "mp3_preview": "https://storage.googleapis.com/suonora-public/voices/Axel.mp3"
    }
  ]
}
```

```
```