Vue d’ensemble
POST /v1/translate traduit entre le haoussa et le français, dans les deux sens. Il reçoit un texte ou un enregistrement, et peut aussi renvoyer la traduction parlée : une seule requête transforme ainsi une note vocale en haoussa en audio en français.
- Modèle :
translation(bêta) - Sens :
ha → fretfr → ha - Entrée : du texte en JSON (jusqu’à 2 000 caractères), ou de l’audio comme pour la transcription
- Ce qui est compté : pour un texte, le nombre de caractères ÷ 15, en secondes ; pour l’audio, la durée envoyée ; plus la traduction parlée si vous la demandez
La traduction est rédigée par Google Gemini via OpenRouter, qui reçoit le texte à traduire (et, pour le français parlé, l’enregistrement, afin de le mettre par écrit). Prévenez vos utilisateurs si leurs messages partent chez un tiers. La transcription et la synthèse vocale tournent sur les propres modèles de Namu.
Traduire un texte
Envoyez du JSON.target est la langue que vous voulez ; source est l’autre, sauf indication contraire.
Réponse
Les traductions montrées dans cette documentation illustrent la forme de la réponse. Vos résultats varieront selon le texte.
Traduire la parole
Envoyez l’enregistrement dansfile. L’API écrit ce qui a été dit (source_text), puis le traduit (text) :
422 nothing_heard.
Recevoir la traduction parlée
Ajoutezinclude_audio et la réponse contient un champ audio : la traduction parlée, en WAV base64 (24 kHz, mono). Avec du JSON, mettez-le dans le corps ; avec de l’audio, en champ de formulaire ou en paramètre de requête.
Python
Requête
string
Le texte à traduire, jusqu’à 2 000 caractères. Envoyez ce champ ou
file.file
Un enregistrement à traduire. Envoyez ce champ ou
text.string
défaut:"fr"
La langue vers laquelle traduire :
ha ou fr.string
La langue de l’entrée :
ha ou fr. Par défaut, la langue qui n’est pas target.boolean
défaut:"false"
Renvoyer aussi la traduction parlée, en WAV base64.
Bonnes pratiques
- Traduisez des phrases entières. Le modèle s’appuie sur la phrase autour d’un mot pour en choisir le sens ; un fragment perd ce contexte.
- Montrez les deux textes quand c’est important.
source_textpermet au lecteur de vérifier ce qui a été compris avant de se fier à la traduction. - Gardez une personne dans la boucle quand l’enjeu est élevé. Les messages médicaux, juridiques et financiers méritent une vérification humaine avant d’arriver aux gens.
Limites
- Haoussa et français uniquement. Le zarma ⇄ français n’est pas encore dans l’API (
400 unsupported_pair). - 2 000 caractères de texte, ou 25 Mo et 5 minutes d’audio, par requête.
Voir aussi
Construire un interprète
Tutoriel
Transcription
Les mêmes règles pour l’audio
Référence de l’API
POST /v1/translate