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

# Authentication

## API Keys

To access the Faseeh API, you'll need an API key. This key serves as your authentication credential and is required for all API requests.

### How it works

Include your API key in every request by adding it to the `x-api-key` HTTP header:

```bash theme={null}
x-api-key: YOUR_API_KEY
```

### API Key Features

Your API keys can be configured with:

* **Endpoint restrictions:** Control which API endpoints each key can access
* **Usage limits:** Set custom quotas to manage and monitor your API consumption

### Security Best Practices

<Warning>
  Keep your API key secure and private. Never commit it to version control, share it publicly, or include it in client-side applications where it could be exposed.
</Warning>

### Making requests

You can paste the command below into your terminal to run your first API request. Make sure to replace `$FASEEH_API_KEY` with your secret API key.

```bash theme={null}
curl 'https://api.faseeh.ai/api/v1/text-to-speech/faseeh-v1-preview' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: $FASEEH_API_KEY' \
  -d '{
    "voice_id": "ar-najdi-male-2",
    "text": "مرحبا بك في فصيح",
    "stability": 0.5,
    "streaming": true,
    "speed": 1
  }'
```

Example with Python:

```python theme={null}
import requests

headers = {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
}

response = requests.post(
    'https://api.faseeh.ai/api/v1/text-to-speech/faseeh-v1-preview',
    headers=headers,
    json={
        'voice_id': 'ar-najdi-male-2',
        'text': 'مرحبا بك في فصيح',
        'stability': 0.5,
        'streaming': True,
        'speed': 1
    }
)
```

Example with Node.js:

```javascript theme={null}
const response = await fetch('https://api.faseeh.ai/api/v1/text-to-speech/faseeh-v1-preview', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    voice_id: 'ar-najdi-male-2',
    text: 'مرحبا بك في فصيح',
    stability: 0.5,
    streaming: true,
    speed: 1
  })
});
```