Comment demander de l'aide

Une adresse et c'est tout : support@uttera.ai. Une personne répond.

Il n'y a pas de formulaire, pas de numéro de ticket, et pas de bot demandant si vous avez essayé de redémarrer. Quand le volume l'exigera, nous construirons quelque chose avec plus de machinerie, et ce sera dit ici ; d'ici là, un e-mail arrive plus tôt et reçoit une réponse tout autant.

Ce qu'il faut nous envoyer

Ceci suffit presque toujours pour comprendre ce qui s'est passé sans avoir à vous demander autre chose :

Et si le problème concerne un fichier audio précis, vous n'avez pas besoin de l'envoyer pour commencer. Presque tout se diagnostique à partir de l'identifiant de requête. Si nous avions un jour besoin de l'audio, nous le demanderions et expliquerions pour quoi — ce qui est la seule façon qu'un de vos enregistrements finisse entre nos mains plus longtemps que les secondes qu'il faut pour le traiter.

Combien de temps nous prenons

Voici ce à quoi nous nous engageons. C'est le délai de première réponse les jours ouvrés, non le délai de résolution : certaines pannes se règlent en dix minutes et d'autres non, mais savoir que quelqu'un s'en occupe ne devrait pas dépendre de la chance.

Si quelque chose est réellement cassé

Si vous pensez avoir trouvé un bug de notre part — non une question d'usage — dites-le dans l'objet. Nous nous en occupons avant tout le reste, et s'il s'avère que vous aviez raison, nous le publierons : dans cette documentation si cela change quelque chose d'écrit ici, et dans le changelog si cela touche au service.

Et si ce que vous avez trouvé est un problème de sécurité, écrivez-le à la même adresse avec [seguridad] dans l'objet et ne le publiez pas entre-temps. Nous répondrons avec ce que nous savons et avec un délai.

Questions fréquentes

Démarrer et compte

Comment obtenir une clé d'API ? Inscrivez-vous sur app.uttera.ai et générez-la dans votre compte. Elle voyage dans l'en-tête Authorization: Bearer sk-....

Puis-je avoir plusieurs clés ? Oui. Créez-en une par intégration (web, mobile, un connecteur…) pour pouvoir en révoquer une sans toucher aux autres.

Comment révoquer ou renouveler une clé ? Depuis votre compte : supprimez l'ancienne et créez-en une nouvelle. La révocation est immédiate.

Y a-t-il une offre gratuite ? Oui, avec un quota mensuel pour l'essayer. Ce que chaque offre inclut est sur Offres.

Comment changer d'offre ? Depuis votre compte. En montant d'offre, la différence au prorata est facturée et la nouvelle offre s'applique aussitôt.

Y a-t-il des offres annuelles ? Oui, avec une remise sur le mensuel. Voir Offres.

Comment voir ma consommation ? Votre compte affiche la consommation, le crédit restant et un historique des requêtes.

Que se passe-t-il quand mon crédit est épuisé ? Vous recevez des alertes à 80 % et 100 %. Une fois épuisé, les requêtes payantes renvoient 402 jusqu'à ce que vous rechargiez ou changiez d'offre.

Puis-je acheter du crédit sans changer d'offre ? Oui, des packs de crédits s'ajoutent à votre quota.

Comment payer ? Par carte, et aussi en cryptomonnaie (Bitcoin). La facture inclut votre numéro de TVA si vous l'indiquez dans votre compte.

Erreurs et codes

401 — non autorisé. La clé est absente ou incorrecte. Vérifiez que vous envoyez Authorization: Bearer <votre-clé> et que la clé est toujours active.

403 — interdit. Votre offre n'inclut pas cette action. Voyez ce qu'inclut chaque offre sur Offres et montez d'offre si besoin.

413 — trop volumineux. L'audio ou le texte dépasse la limite de cette action. Réduisez ou raccourcissez le fichier, ou utilisez le mode asynchrone. Les limites sont dans Référence.

402 — crédits insuffisants. Votre crédit du mois est épuisé. Achetez un pack de crédits ou changez d'offre.

429 — trop de requêtes. Vous allez trop vite. Réessayez avec une attente croissante (backoff) entre les appels.

500 / 503 — erreur serveur. En général temporaire. Réessayez ; si cela persiste, écrivez-nous avec le X-Request-Id.

504 sur un résumé long. Le mode synchrone de /v1/summarize s'arrête à 10 minutes et ne facture pas. Pour un audio long, utilisez le mode asynchrone, sans ce plafond.

Qu'est-ce que le X-Request-Id ? Un en-tête de la réponse qui identifie votre requête exacte. Envoyez-le-nous lorsque vous demandez de l'aide et nous trouverons ce qui s'est passé sans rien d'autre.

Transcription

Quels formats audio acceptez-vous ? wav, mp3, m4a, ogg, opus, flac, webm, aac et amr.

Y a-t-il une taille maximale d'audio ? Oui, et il y a une limite de durée en mode synchrone. Pour les fichiers volumineux ou longs, utilisez le mode asynchrone. Détail dans Référence.

Quelles langues transcrivez-vous ? Beaucoup ; la liste par action est dans Référence. Si la détection échoue, passez la langue explicitement.

Ma transcription est vide ou erronée. C'est souvent un audio sans voix/silence, une langue mal détectée (fixez language) ou un fichier corrompu. Vérifiez l'audio et réessayez.

Me dit-elle qui parle et quand ? Oui, avec la diarisation : elle renvoie des segments avec locuteur et horodatage.

Est-ce compatible avec l'API d'OpenAI ? Oui. Pointez votre SDK OpenAI vers notre point d'accès et utilisez les mêmes noms (p. ex. whisper-1). Voir Intégration.

Voix et clonage

Quelles voix et quelles langues existent ? Un catalogue de voix par langue ; la liste est dans Studio.

Puis-je cloner une voix ? Oui : vous donnez un court échantillon de la voix et le texte à dire. Il y a une limite de caractères par requête (voir Référence).

Faut-il une autorisation pour cloner une voix ? Oui. Une voix est une donnée biométrique : ne clonez que votre propre voix ou une voix avec consentement explicite. Cloner un tiers pour l'usurper est illégal.

L'audio généré porte-t-il un filigrane ? Oui, un filigrane inaudible exigé par le Règlement IA de l'UE (art. 50.2). Il ne peut pas être désactivé.

Traduction

Traduisez-vous le texte et la voix ? Les deux : en texte, ou traduit et parlé.

Puis-je garder ma voix en traduisant ? Oui : en traduisant la voix, vous pouvez conserver la voix d'origine du locuteur au lieu d'une voix du catalogue.

Quelles langues de traduction existent ? Dans Référence. Certains codes ont des particularités (p. ex. le norvégien ou le chinois) ; la doc les signale.

Résumé et rapport vérifiable

Pouvez-vous résumer un enregistrement ? Oui : il transcrit et renvoie un résumé structuré (points clés, données, tâches, qui a parlé).

Qu'est-ce que le rapport vérifiable ? Un PDF signé avec un graphe de preuves que n'importe qui peut vérifier : il relie chaque affirmation au moment de l'audio. Voir Rapport vérifiable.

Comment vérifier un rapport ? Avec l'action de vérification : elle contrôle la signature (Ed25519) et que le PDF n'a pas été modifié.

Sons et musique

Générez-vous des effets sonores ? Oui, à partir d'une description (une porte, la pluie, des pas), et aussi des scènes sonores avec plusieurs événements mélangés.

Et de la musique ? Oui, un morceau à partir d'une description. Le coût dépend de la durée × étapes de qualité ; ajustez les deux.

Quelle licence a la musique générée ? Pour votre usage selon les conditions ; détail dans la doc Sons et musique. Elle porte le filigrane de l'art. 50.2.

Prononciation

Analysez-vous la prononciation ? Oui : vous comparez un enregistrement à une phrase de référence et il renvoie la précision, les phonèmes attendus vs entendus et les erreurs groupées. Voir Prononcer.

Confidentialité, légal et données

Entraînez-vous sur mes données ? Non. Votre audio et votre texte ne servent pas à l'entraînement et ne sont pas réutilisés. Voir Confidentialité.

Où mes données sont-elles traitées ? Dans l'UE, sur notre propre infrastructure. Voir Confidentialité et Durabilité.

Combien de temps gardez-vous l'audio ? Dans les travaux asynchrones, le contenu est chiffré par travail et supprimé automatiquement après un court délai. Détail dans Confidentialité.

Avez-vous le RGPD / un accord de traitement (DPA) ? Oui. Voir Cadre légal.

Puis-je demander la suppression de mes données ? Oui, écrivez-nous. Voir Cadre légal.

Intégrations et connecteurs

Est-ce compatible avec le SDK d'OpenAI ? Oui : changez la base_url vers notre point d'accès et réutilisez votre code. Voir Intégration.

Avez-vous un connecteur pour Claude / ChatGPT / Gemini ? Oui, une Skill qui téléverse l'audio depuis le bac à sable du modèle sans que l'audio passe par le LLM. Voir Connecteurs.

Et un serveur MCP ? Oui (audio par URL publique uniquement). Pour les fichiers locaux, utilisez la Skill. Voir Connecteurs.

Slack et Telegram ? Oui, des bots transcrivent l'audio que vous leur envoyez. Voir Connecteurs.

n8n ? Oui, il existe des nœuds Uttera pour n8n.

Avez-vous des applications pour l'utiliser sans coder ? Oui, des applis web installables : Résumé, Interprète (voix↔voix) et Coach de prononciation.

La Skill me renvoie une erreur réseau dans Claude. Sur les comptes Team/Enterprise, un administrateur doit autoriser api.uttera.ai dans la liste blanche réseau de l'organisation. Sur les offres individuelles, ce n'est pas nécessaire. Voir Connecteurs.

Asynchrone et webhooks

Puis-je envoyer des travaux longs sans attendre ? Oui : le mode asynchrone met le travail en file et vous prévient par webhook à la fin, sans le plafond synchrone de 10 minutes.

Les webhooks sont-ils signés ? Oui, avec HMAC, pour que vous vérifiiez qu'ils viennent de nous.