Passer au contenu principal
L’agent vocal est un aperçu de recherche. Servez-vous-en pour explorer et pour nous dire ce dont vous avez besoin, pas pour quoi que ce soit dont des personnes dépendent. Ses réponses peuvent être fausses, et il peut changer sans le préavis que nous donnons pour les modèles en bêta.

Vue d’ensemble

POST /v1/converse traite un tour de conversation. Vous envoyez ce que la personne a dit ; l’API renvoie ce qu’elle a entendu, une réponse écrite en haoussa, et cette réponse dite par Nadia. Faites écouter l’audio, enregistrez ce que la personne dit ensuite, et envoyez-le à nouveau.
  • Modèle : voice-agent (recherche)
  • Langue : haoussa
  • Personnage : nadia
  • Ce qui est compté : l’audio que vous envoyez plus la réponse parlée
Les mots entendus sont envoyés à Google Gemini via OpenRouter, qui rédige la réponse ; Namu ne conserve aucune conversation, seulement des métadonnées sur chaque appel (durée, statut, temps de réponse).

Activer la permission

Les nouvelles clés n’incluent pas la permission converse. Quand vous créez une clé dans la console, cochez Agent vocal. Une clé sans cette permission reçoit 403 insufficient_scope.

Un tour de parole

Réponse

Requête

file
requis
Ce que la personne a dit. Tout format accepté par la transcription.
string
défaut:"nadia"
Qui répond. nadia est le seul personnage.
string
Votre propre identifiant pour la conversation, jusqu’à 100 caractères. Il revient dans la réponse pour que vous puissiez associer les tours ; l’API ne le conserve jamais.

Ce qu’il ne fait pas encore

  • Pas de mémoire d’un tour à l’autre. Chaque requête est indépendante ; l’API ne garde pas la conversation.
  • Pas de diffusion en continu. La réponse arrive quand elle est prête, en un seul fichier.
  • Haoussa uniquement.
Si aucune parole n’est trouvée dans l’enregistrement, la réponse est 422 nothing_heard : demandez à la personne de parler à nouveau.

Voir aussi

Parler à l’agent vocal

Tutoriel

Référence de l’API

POST /v1/converse