> ## 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. # Créer une traduction > Traduit entre le haoussa et le français, dans les deux sens. Envoyez du JSON pour traduire un texte, ou de l’audio (champ multipart `file`, ou corps brut) pour traduire de la parole. Ajoutez `include_audio` pour recevoir aussi la traduction parlée. Un texte compte son nombre de caractères divisé par 15, en secondes ; la parole compte l’audio envoyé. Nécessite la permission `translate`. ## OpenAPI ````yaml fr/api-reference/openapi.yaml POST /v1/translate openapi: 3.1.0 info: title: API Namu version: 1.0.0 description: >- Reconnaissance vocale, synthèse vocale, traduction et un agent vocal pour le haoussa, le zarma et le français. Décrit l’API telle qu’elle se comporte le 8 novembre 2026. contact: name: Namu AI Lab email: contact@namuai.org url: https://www.namuai-lab.com servers: - url: https://api.namuai-lab.com description: Production security: - bearerAuth: [] tags: - name: Speech description: Synthèse vocale. - name: Transcription description: Reconnaissance vocale. - name: Translation description: Haoussa et français, à partir d’un texte ou de la parole. - name: Voice agent description: Une conversation parlée en haoussa. En recherche. - name: Models and voices description: Ce que propose l’API. Aucune clé nécessaire. - name: Account description: Votre consommation ce mois-ci. paths: /v1/translate: post: tags: - Translation summary: Créer une traduction description: >- Traduit entre le haoussa et le français, dans les deux sens. Envoyez du JSON pour traduire un texte, ou de l’audio (champ multipart `file`, ou corps brut) pour traduire de la parole. Ajoutez `include_audio` pour recevoir aussi la traduction parlée. Un texte compte son nombre de caractères divisé par 15, en secondes ; la parole compte l’audio envoyé. Nécessite la permission `translate`. operationId: createTranslation parameters: - name: include_audio in: query required: false description: >- `1`, `true` ou `yes` pour ajouter la traduction parlée (WAV en base64) à la réponse. schema: type: string enum: - '1' - 'true' - 'yes' - name: source in: query required: false description: Seulement quand l’audio est le corps brut. schema: $ref: '#/components/schemas/TranslateLanguage' - name: target in: query required: false description: Seulement quand l’audio est le corps brut. schema: $ref: '#/components/schemas/TranslateLanguage' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TranslateTextRequest' example: text: Ina kwana? Yau za a yi zafi sosai. source: ha target: fr multipart/form-data: schema: type: object required: - file properties: file: type: string format: binary description: L’enregistrement. source: $ref: '#/components/schemas/TranslateLanguage' target: $ref: '#/components/schemas/TranslateLanguage' include_audio: type: string enum: - '1' - 'true' - 'yes' responses: '200': description: >- La traduction. `characters` pour un texte, `audio_seconds` pour de la parole. headers: X-Request-Id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/Translation' example: model: translation source: ha target: fr source_text: Ina kwana? Yau za a yi zafi sosai. text: Bonjour ! Il va faire très chaud aujourd'hui. characters: 34 audio: null '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '413': $ref: '#/components/responses/TooLarge' '415': $ref: '#/components/responses/UnsupportedAudio' '422': $ref: '#/components/responses/NothingHeard' '429': $ref: '#/components/responses/TooManyRequests' '502': $ref: '#/components/responses/Upstream' components: schemas: TranslateLanguage: type: string enum: - ha - fr description: >- `ha` haoussa ou `fr` français. Par défaut, la source est l’autre langue que la cible. TranslateTextRequest: type: object required: - text properties: text: type: string maxLength: 2000 description: Le texte à traduire. Jusqu’à 2 000 caractères. source: $ref: '#/components/schemas/TranslateLanguage' target: type: string enum: - ha - fr default: fr description: La langue vers laquelle traduire. include_audio: type: boolean description: Renvoyer aussi la traduction parlée (WAV en base64). Translation: type: object properties: model: type: string example: translation source: type: string example: ha target: type: string example: fr source_text: type: string description: Le texte envoyé, ou ce qui a été entendu dans l’audio. text: type: string description: La traduction. characters: type: integer description: 'Requêtes de texte : caractères traduits.' audio_seconds: type: number description: 'Requêtes audio : durée de l’audio envoyé.' audio: type: - string - 'null' description: La traduction parlée, en WAV base64, quand elle est demandée. Error: type: object properties: error: type: object properties: type: type: string description: Un code stable, comme `invalid_api_key`. message: type: string description: Ce qui s’est passé, en termes simples. request_id: type: string headers: RequestId: description: >- Un identifiant unique pour cette requête. Indiquez-le quand vous nous écrivez. schema: type: string example: 3f2a9c1e5b7d4e8fa0c2b6d9e1f3a5c7 responses: BadRequest: description: >- La requête n’était pas utilisable : `invalid_request`, `invalid_json`, `missing_text`, `missing_file`, `empty_audio`, `unknown_voice`, `unsupported_language`, `unsupported_pair`, `unknown_persona`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: unknown_voice message: 'Unknown voice. Try one of: nadia, warm, fr, mouhamad.' request_id: 3f2a9c1e5b7d4e8fa0c2b6d9e1f3a5c7 Unauthorized: description: >- Pas de clé, une clé qui n’est pas une clé Namu, ou une clé révoquée : `missing_api_key`, `invalid_api_key`, `key_revoked`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: missing_api_key message: 'Send your key as ''Authorization: Bearer namu_sk_...''.' request_id: 3f2a9c1e5b7d4e8fa0c2b6d9e1f3a5c7 Forbidden: description: >- `insufficient_scope` (la clé ne peut pas appeler ce point d’accès) ou `account_paused`. content: application/json: schema: $ref: '#/components/schemas/Error' TooLarge: description: >- `payload_too_large` (plus de 25 Mo), `audio_too_long` (plus de 300 s) ou `text_too_long` (plus de 2 000 caractères). content: application/json: schema: $ref: '#/components/schemas/Error' UnsupportedAudio: description: >- `unsupported_audio` : le fichier n’a pas pu être lu. Envoyez du WAV, MP3, M4A, AAC, OGG, WebM ou FLAC. content: application/json: schema: $ref: '#/components/schemas/Error' NothingHeard: description: '`nothing_heard` : aucune parole n’a été trouvée dans l’audio.' content: application/json: schema: $ref: '#/components/schemas/Error' TooManyRequests: description: >- `rate_limited` (trop de requêtes cette minute ; voir `Retry-After`) ou `quota_exceeded` (le quota de ce mois est épuisé). headers: Retry-After: description: >- Nombre de secondes à attendre. Envoyé avec `rate_limited` uniquement. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/Error' Upstream: description: >- `upstream_error` : le modèle n’a pas répondu. Réessayez ; une requête qui échoue n’est pas décomptée. content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: bearerAuth: type: http scheme: bearer description: >- Votre clé secrète : `Authorization: Bearer namu_sk_...`. Créez-en une sur https://www.namuai-lab.com/fr/account/keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.