Démarrage rapide

L’API Namu est une simple API HTTPS : chaque requête est un POST ou un GET vers https://api.namuai-lab.com/v1/..., avec votre clé dans l’en-tête Authorization. Tout ce qui sait envoyer du HTTP peut l’utiliser.

Créer une clé d’API

Connectez-vous à la console Namu et ouvrez Clés d’API. Créez une clé, donnez-lui un nom que vous reconnaîtrez, et copiez-la. Elle commence par namu_sk_ et ne s’affiche qu’une fois.

Votre clé est un mot de passe. Gardez-la sur votre serveur : ne la mettez jamais dans une application mobile, une page web ou un dépôt public. Quiconque la détient peut consommer votre quota.

Enregistrer la clé dans une variable d’environnement

Votre code lit la clé dans l’environnement : elle ne se trouve donc jamais dans un fichier que vous pourriez partager.

export NAMU_API_KEY="namu_sk_..."

setx NAMU_API_KEY "namu_sk_..."

Sous Windows, ouvrez ensuite un nouveau terminal pour qu’il voie la variable.

Faire votre première requête

Demandez à Nadia de dire « Sannu da zuwa! Muna farin cikin jin muryarku. » (Bienvenue ! Nous sommes heureux d’entendre votre voix.)

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"}' \
  -o welcome.wav

import os
import requests

response = requests.post(
    "https://api.namuai-lab.com/v1/speech",
    headers={"Authorization": f"Bearer {os.environ['NAMU_API_KEY']}"},
    json={"text": "Sannu da zuwa! Muna farin cikin jin muryarku.", "voice": "nadia"},
    timeout=120,
)
response.raise_for_status()

with open("welcome.wav", "wb") as f:
    f.write(response.content)
print("Saved", response.headers["X-Audio-Seconds"], "seconds of audio")

import { writeFile } from "node:fs/promises";

const response = await fetch("https://api.namuai-lab.com/v1/speech", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.NAMU_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ text: "Sannu da zuwa! Muna farin cikin jin muryarku.", voice: "nadia" }),
});
if (!response.ok) throw new Error((await response.json()).error.message);

await writeFile("welcome.wav", Buffer.from(await response.arrayBuffer()));
console.log("Saved", response.headers.get("X-Audio-Seconds"), "seconds of audio");

L’écouter

Ouvrez welcome.wav. C’est votre application qui parle haoussa. La première requête après un moment d’inactivité peut prendre un peu plus de temps, le temps que le modèle se réveille ; les suivantes sont plus rapides.

Et maintenant, qu’elle écoute

Renvoyez à l’API le fichier que vous venez de créer, et lisez ce qu’elle a entendu :

curl https://api.namuai-lab.com/v1/transcribe \
  -H "Authorization: Bearer $NAMU_API_KEY" \
  -F file=@welcome.wav \
  -F language=ha

with open("welcome.wav", "rb") as audio:
    response = requests.post(
        "https://api.namuai-lab.com/v1/transcribe",
        headers={"Authorization": f"Bearer {os.environ['NAMU_API_KEY']}"},
        files={"file": audio},
        data={"language": "ha"},
        timeout=120,
    )
print(response.json()["text"])

import { readFile } from "node:fs/promises";

const form = new FormData();
form.append("file", new Blob([await readFile("welcome.wav")]), "welcome.wav");
form.append("language", "ha");

const heard = await fetch("https://api.namuai-lab.com/v1/transcribe", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.NAMU_API_KEY}` },
  body: form,
}).then((r) => r.json());
console.log(heard.text);

Réponse

{
  "model": "speech-recognition",
  "text": "sannu da zuwa muna farin cikin jin muryarku",
  "language": "ha",
  "audio_seconds": 3.1
}

Les transcriptions sont écrites en minuscules, sans ponctuation. Ajoutez la vôtre si votre écran en a besoin.

Étapes suivantes

Choisir une voix

Nadia en haoussa, Mouhamad en zarma et en haoussa, et la voix française.

Traduire

Du haoussa vers le français et inversement, à partir d’un texte ou de la parole.

Utiliser un SDK

Un petit client Python ou JavaScript que vous pouvez coller dans votre projet.

Suivre votre consommation

Comment chaque requête est décomptée de vos 30 minutes gratuites.

Démarrer

SDK et outils

Applications mobiles

Ressources

Démarrage rapide

Et maintenant, qu’elle écoute

Étapes suivantes

Choisir une voix

Traduire

Utiliser un SDK

Suivre votre consommation

​Et maintenant, qu’elle écoute

​Étapes suivantes

Choisir une voix

Traduire

Utiliser un SDK

Suivre votre consommation

Et maintenant, qu’elle écoute

Étapes suivantes