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.

Go to namuai-lab.com/account/keys, create an account, then Create new secret key. Copy the key: it is shown once.

Put the key in your terminal

export NAMU_API_KEY="namu_sk_..."

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

Ask Nadia to speak

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.

Listen

Open welcome.mp3: “Welcome! We are glad to hear your voice.” Then try Zarma:

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.

Quickstart

The same, in Python and JavaScript

Read messages aloud

Next tutorial

Production

Build

Your first call in five minutes

If something goes wrong

Next

Quickstart

Read messages aloud

​If something goes wrong

​Next

Quickstart

Read messages aloud

If something goes wrong

Next