L’API publique Speechdash est en ligne

L’API publique Speechdash est disponible sur api.speechdash.com/v1. Si vous construisez un produit où il faut écouter du texte, vous pouvez créer des documents et générer de la synthèse vocale sans passer par l’interface web.

Ce billet résume ce qui est livré, comment la facturation fonctionne, et comment envoyer une première requête en quelques minutes.

Ce que l’API permet aujourd’hui

L’API REST reprend la pile d’écoute que vous connaissez déjà dans l’application :

• Créer et gérer des documents dans la bibliothèque Speechdash d’un compte (import de texte avec titre et langue)
• Générer de la synthèse vocale avec les préréglages Narrateur, Questionneur et Expert, en de nombreuses langues
• Lister, lire, mettre à jour et supprimer des documents via des points de terminaison JSON prévisibles

Les documents créés par l’API apparaissent dans la bibliothèque sur speechdash.com. Vos utilisateurs peuvent continuer à écouter dans l’app, éditer le texte, exporter l’audio ou reprendre sur un autre appareil.

La synthèse vocale utilise les mêmes voix cloud que la lecture dans le produit. L’usage est débité du portefeuille de crédits du compte, avec les mêmes règles que la lecture cloud dans l’application.

Pour qui

Les équipes utilisent l’API quand l’écoute doit vivre dans un autre produit :

• LMS et plateformes d’étude qui veulent une lecture à voix haute sur des devoirs ou des articles
• Couches d’accessibilité dans des outils SaaS
• Outils internes qui importent du contenu en lot pour relecture à l’oreille
• Prototypes qui ont besoin d’un aperçu oral avant une interface complète

Si vos utilisateurs ont déjà un compte Speechdash, ils gardent un seul portefeuille et une seule bibliothèque. L’API est une porte d’entrée de plus, pas un produit séparé.

Authentification et documentation

Chaque compte crée des clés API dans Paramètres → API sur speechdash.com/settings/api. La clé n’est affichée qu’une fois ; seul un préfixe est conservé côté serveur.

Envoyez Authorization: Bearer sh_live_… à chaque requête. Une clé invalide ou révoquée renvoie une réponse 401.

La documentation développeur est dans le centre d’aide :

• Vue d’ensemble de l’API (authentification, limites, facturation, idempotence)
• Contrat OpenAPI en direct sur api.speechdash.com/v1/openapi.json

La page produit API publique résume l’offre pour les personnes non développeuses de votre équipe.

Facturation en bref

Les requêtes de synthèse bloquent une estimation, puis soldent la durée mesurée. Les nouvelles tentatives peuvent envoyer une Idempotency-Key à la création de document et à la synthèse pour éviter une double facturation après un problème réseau.

Des limites de débit s’appliquent par compte (pas par clé). Les réponses incluent les en-têtes habituels et Retry-After quand il faut temporiser.

Première requête en cinq minutes

1. Connectez-vous sur speechdash.com et ouvrez Paramètres → API
2. Créez une clé et copiez-la tout de suite
3. Lisez la vue d’ensemble de l’API
4. Faites un POST avec un court texte sur /v1/documents, ou appelez /v1/audio/speech avec un préréglage de voix et une langue

Commencez par deux phrases avant de traiter un chapitre entier. La vue d’ensemble liste les champs exacts et des exemples de réponses.

La suite

Nous ferons évoluer l’API selon les besoins produit. Si vous intégrez dès maintenant, rejoignez Discord pour vos retours ou ouvrez le centre d’aide si un point du contrat n’est pas clair.

Merci de construire avec Speechdash. Nous avons hâte de voir ce que vous livrez.

Guides associés

• Page fonctionnalité API publique
• Comment démarrer avec Speechdash
• Lecture cloud
• Formats d’import
• Ce qui consomme des crédits