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

# Namu API

> Speech recognition, speech synthesis, translation and a voice agent for Hausa, Zarma and French, through one key.

## Developer quickstart

Make your first request in minutes: send a sentence in Hausa, Zarma or French and get it back as speech, or send a voice note and get its text.

[Get started](https://developers.namuai-lab.com/quickstart.md)
[Create API key](https://www.namuai-lab.com/account/keys)

```python Python theme={null}
from namu import Namu

client = Namu()  # reads NAMU_API_KEY

audio = client.speech("Sannu da zuwa!", voice="nadia")
open("welcome.wav", "wb").write(audio)
```

```javascript JavaScript theme={null}
import { writeFile } from "node:fs/promises";
import { Namu } from "namu-ai";

const namu = new Namu(); // reads NAMU_API_KEY

const audio = await namu.speech("Sannu da zuwa!", { voice: "nadia" });
await writeFile("welcome.wav", Buffer.from(audio));
```

```bash cURL theme={null}
curl https://api.namuai-lab.com/v1/speech \
  -H "Authorization: Bearer $NAMU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Sannu da zuwa!", "voice": "nadia"}' \
  -o welcome.wav
```

Build with the Namu API in your coding agentGive Claude Code, Codex or Cursor the API as plain text: every page here has a Markdown copy, and llms.txt holds the whole API in one file.

[Open llms.txt](https://www.namuai-lab.com/llms.txt)

## Build paths

[Speech API
Turn text into speech, speech into text, and Hausa into French or back, with one key and plain HTTPS.
Start with the quickstart](https://developers.namuai-lab.com/quickstart.md)

[SDKs for Python and JavaScript
`pip install namu-ai` or `npm install namu-ai`: typed responses, retries, and one error class per status.
Start with the SDKs](https://developers.namuai-lab.com/sdks/overview)

Models
[View all](https://developers.namuai-lab.com/models.md)

One model for each job, on its own endpoint, with the same limits and the same shape for every error.

[speech-synthesis
Text to speech
Speaks Hausa, Zarma and French in three voices.
Beta](https://developers.namuai-lab.com/capabilities/text-to-speech.md)

[speech-recognition
Speech to text
Writes down Hausa, Zarma and French speech, voice notes included.
Beta](https://developers.namuai-lab.com/capabilities/speech-to-text.md)

[translation
Translation
Hausa to French and French to Hausa, from text or from speech.
Beta](https://developers.namuai-lab.com/capabilities/translation.md)

[voice-agent
Voice agent
One spoken turn in Hausa: it listens, answers and speaks the answer.
Research](https://developers.namuai-lab.com/capabilities/voice-agent.md)

## Start building

[Read messages aloud
Turn reminders and lessons into speech in Hausa, Zarma or French](https://developers.namuai-lab.com/tutorials/read-aloud-in-hausa.md)

[Transcribe voice notes
Get the text of a WhatsApp voice note or a phone recording](https://developers.namuai-lab.com/tutorials/transcribe-a-voice-note.md)

[Translate Hausa and French
Build an interpreter that hears one language and answers in the other](https://developers.namuai-lab.com/tutorials/hausa-french-interpreter.md)

[Talk with the voice agent
Send a spoken question in Hausa and play the spoken reply](https://developers.namuai-lab.com/tutorials/talk-to-the-voice-agent.md)

[Build for weak networks
Small audio, short waits and retries for phones on costly data](https://developers.namuai-lab.com/guides/weak-networks.md)

[Go to production
Keys, errors, limits and usage before real people use your app](https://developers.namuai-lab.com/guides/production-checklist.md)

[Help and supportQuestions about your account, keys and usage](https://developers.namuai-lab.com/resources/support.md)
[ChangelogWhat changed in the API and the SDKs](https://developers.namuai-lab.com/resources/changelog.md)
[API referenceEvery endpoint, parameter and response](https://developers.namuai-lab.com/api-reference/introduction.md)
[Responsible useWhat the voices may and may not be used for](https://developers.namuai-lab.com/resources/responsible-use.md)


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