> ## 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

> Learn about Suonora's API endpoints, authentication, base URL, and available operations.

# Introduction

Welcome to the Suonora API documentation. This guide will help you get started with our text-to-speech API.

## Base URL

All API requests should be made to:

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

## Authentication

All API requests require authentication using an API key. Include your API key in the `Authorization` header:

```
Authorization: Bearer YOUR_API_KEY
```

<Note>
  Keep your API key secure and never share it publicly. You can find your API
  key in the [Suonora Dashboard](https://suonora.com/).
</Note>

## Available Endpoints

<CardGroup cols={2}>
  <Card title="Speech API" icon="microphone" href="/api-reference/endpoint/speech">
    Convert text to speech and generate high-quality audio files.
  </Card>

  <Card title="Streaming API" icon="radio" href="/api-reference/endpoint/stream">
    Stream audio in real-time for immediate playback.
  </Card>

  <Card title="Voices API" icon="users" href="/api-reference/endpoint/voices">
    List available voices and their characteristics.
  </Card>

  <Card title="Balance API" icon="wallet" href="/api-reference/endpoint/balance">
    Check your account balance and usage statistics.
  </Card>
</CardGroup>

## Response Format

All API responses are returned in JSON format. A successful response includes:

```json
{
  "success": true,
  "data": {
    // Response data here
  }
}
```

Error responses follow this format:

```json
{
  "success": false,
  "message": "Error description"
}
```

## Rate Limits

Rate limits are based on your subscription plan:

| Plan     | Requests per Minute | Concurrent Jobs |
| -------- | ------------------- | --------------- |
| Personal | 60                  | 1               |
| Superior | 120                 | 2               |
| Pro      | 300                 | 5               |

<Note>
  Rate limits are enforced per API key. Consider upgrading your plan if you need
  higher limits.
</Note>

## Best Practices

1. **Error Handling**

   * Always check the `success` field in responses
   * Implement proper error handling for all API calls
   * Use appropriate HTTP status codes

2. **Performance**

   * Cache voice lists when possible
   * Implement retry logic with exponential backoff
   * Monitor your rate limit usage

3. **Security**
   * Keep your API key secure
   * Use HTTPS for all requests
   * Rotate API keys periodically

## Need Help?

If you need assistance, please:

1. Contact our support team at [support@suonora.com](mailto:support@suonora.com)
2. Visit our [Documentation](https://docs.suonora.com) for detailed guides

<CardGroup cols={2}>
  <Card title="Quick Start Guide" icon="book" href="/quickstart">
    Get started with Suonora in minutes
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference">
    Detailed API documentation and examples
  </Card>
</CardGroup>