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

# Quickstart

> Learn how to make your first API call to Suonora in under 5 minutes.

## Get Your API Key

Before you can use the Suonora API, you'll need an API key to authenticate your requests.

<AccordionGroup>
  <Accordion icon="key" title="Find Your API Key">
    You can get your API key by signing into your Suonora account and navigating to the **API Keys** section on your [dashboard](https://suonora.com/).

    Copy your secret API key and keep it secure. You will use this key in the `Authorization` header for every API request.
  </Accordion>
</AccordionGroup>

## Generate Your First Audio

This example will guide you through creating your first audio file from text using a simple `cURL` command.

### The API Request

<AccordionGroup>
  <Accordion icon="rectangle-terminal" title="Send a POST request to /speech">
    Use the following command in your terminal to generate an audio file. Remember to replace `YOUR_API_KEY` with your actual secret key.

    ```bash
    curl --request POST \
      --url [https://api.suonora.com/v1/speech](https://api.suonora.com/v1/speech) \
      --header 'Authorization: Bearer YOUR_API_KEY' \
      --header 'Content-Type: application/json' \
      --data '{
        "text": "Hello from the Suonora API!",
        "voice_id": "voice-en-us-1",
        "model_id": "suonora-v1"
      }' \
      --output suonora_speech.mp3
    ```

    <Note>
      This command will create a file named `suonora_speech.mp3` in the same directory where you run it.
    </Note>
  </Accordion>
</AccordionGroup>

## Next Steps

You've successfully generated your first audio file! Here’s what you can explore next to get the most out of the Suonora API.

<CardGroup>
  <Card title="Models & Formats" icon="sliders" href="/guides/models-and-formats">
    Discover all the available voices, models, and audio formats you can use.
  </Card>

  <Card title="API Reference" icon="book-open-cover" href="/api-reference/introduction">
    Get a complete overview of all API endpoints and their parameters.
  </Card>

  <Card title="API Responses & Errors" icon="list" href="/guides/api-responses">
    Learn how to handle different API responses and error codes.
  </Card>
</CardGroup>
