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

# Your first call in five minutes

> Create a key, send one request, and hear your app speak Hausa.

5 min

Your first call in five minutes

**You will need:** a computer with a terminal, and five minutes. Nothing to install: `curl` is already on macOS, Linux and Windows 10 and later.

**1. Sign up and create a key**

Go to [namuai-lab.com/account/keys](https://www.namuai-lab.com/account/keys), create an account, then **Create new secret key**. Copy the key: it is shown once.

**2. Put the key in your terminal**

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
export NAMU_API_KEY="namu_sk_..."
```

On Windows PowerShell: `$env:NAMU_API_KEY = "namu_sk_..."`

**3. Ask Nadia to speak**

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl https://api.namuai-lab.com/v1/speech \
  -H "Authorization: Bearer $NAMU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Sannu da zuwa! Muna farin cikin jin muryarku.", "voice": "nadia", "format": "mp3"}' \
  -o welcome.mp3
```

The first request after a quiet spell can take up to a minute. The next one is quicker.

**4. Listen**

Open `welcome.mp3`: *"Welcome! We are glad to hear your voice."* Then try Zarma:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl https://api.namuai-lab.com/v1/speech \
  -H "Authorization: Bearer $NAMU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Fofo! Mate ni go?", "voice": "mouhamad", "format": "mp3"}' \
  -o fofo.mp3
```

## If something goes wrong

| You see | Do this |
| - | - |
| `missing_api_key` | The `export` did not reach this terminal. Run it again in the same window. |
| `invalid_api_key` | The key was copied in part. Copy it again, or create a new one. |
| The file will not play | Open it in a text editor: if it starts with `{"error"`, the message says why. |

## Next

> [card] [Quickstart](https://developers.namuai-lab.com/quickstart.md)
>
> The same, in Python and JavaScript

> [card] [Read messages aloud](https://developers.namuai-lab.com/tutorials/read-aloud-in-hausa.md)
>
> Next tutorial


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.