Clés API et serveur MCP
Créez des clés API, appelez chaque point de terminaison REST public, et connectez le serveur MCP officiel de Speechdash.
Utilisez Paramètres → API pour créer des clés et connecter des assistants. La même clé sh_live_… autorise l’API REST publique et le serveur MCP officiel. Les connecteurs sous Paramètres → Connecteurs sont une fonctionnalité différente : ils attachent des serveurs MCP de tiers à la messagerie en application.
Créer une clé
- Ouvrez Paramètres → API.
- Cliquez sur Nouvelle clé, nommez-la (par exemple
Serveur de production), et copiez-la immédiatement. Seul le préfixe est enregistré ; le secret complet n’est affiché qu’une seule fois. - Envoyez
Authorization: Bearer sh_live_…depuis votre serveur. Ne placez jamais une clé dans un navigateur, une application mobile ou un dépôt public.
Vous pouvez conserver jusqu’à 10 clés actives. Révoquez une clé compromise depuis la même page.
Vérifiez une clé avec GET /v1/me (email, abonnement et portefeuille). URL de base : https://api.speechdash.com/v1.
Points de terminaison REST
Toutes les routes HTTP publiques :
| Méthode | Chemin | Objectif |
|---|---|---|
GET | /health | État du service (sans clé API ; pas sous /v1) |
GET | /v1/openapi.json | Contrat OpenAPI 3.1 |
GET | /v1/me | Compte, abonnement et portefeuille |
GET | /v1/documents | Liste des documents de la bibliothèque, y compris les transcriptions terminées |
POST | /v1/documents | Crée un document texte (source=api) |
GET | /v1/documents/{document_id} | Lit un document et son texte |
PUT | /v1/documents/{document_id} | Met à jour le titre, le texte, la langue, is_archived, ou visibility |
DELETE | /v1/documents/{document_id} | Supprime un document |
POST | /v1/documents/{document_id}/translate | Nouvelle version traduite (mêmes crédits que l’export MP3 ; horodatages recopiés tels quels) |
GET | /v1/documents/{document_id}/export | Téléchargez pdf, docx, txt, csv, srt, ou vtt |
POST | /v1/audio/speech | Synthétise jusqu’à 5 000 caractères (JSON + audio) |
POST | /v1/audio/stream | Flux WAV, jusqu’à 20 000 caractères |
POST | /v1/audio/stream/with-timestamps | SSE avec audio par phrase et marques |
GET | /v1/voices | Catalogue des voix |
GET | /v1/voices/{voice_id} | Une présélection de voix (par exemple F1) |
L’API ne démarre pas les tâches de transcription audio ou vidéo. Les tâches terminées apparaissent comme des documents de bibliothèque (source=transcription). Pages interactives pour tester : Compte, Documents, Audio, Voix.
Outils MCP
Le serveur officiel à https://mcp.speechdash.com/mcp expose un outil par bibliothèque ou action vocale. ChatGPT utilise OAuth. Cursor et Claude Desktop utilisent Streamable HTTP avec votre clé API personnelle.
| Outil MCP | REST |
|---|---|
speechdash_get_account | GET /v1/me |
speechdash_list_documents | GET /v1/documents |
speechdash_get_document | GET /v1/documents/{document_id} |
speechdash_create_document | POST /v1/documents |
speechdash_update_document | PUT /v1/documents/{document_id} |
speechdash_translate_document | POST /v1/documents/{document_id}/translate |
speechdash_export_document | GET /v1/documents/{document_id}/export |
speechdash_delete_document | DELETE /v1/documents/{document_id} |
speechdash_list_voices | GET /v1/voices |
speechdash_get_voice | GET /v1/voices/{voice_id} |
speechdash_synthesize_speech | POST /v1/audio/speech |
Ressource : speechdash://openapi (JSON OpenAPI en direct).
La synthèse vocale en flux (POST /v1/audio/stream et POST /v1/audio/stream/with-timestamps) n’a pas d’outil MCP. Utilisez REST pour ces routes et pour /health.
Configuration : Serveur MCP et le Hub des Agents.
Crédits
La synthèse vocale (REST et MCP) dépense 0,5 crédit d’affichage (1 centime de portefeuille) pour chaque 30 secondes entamées d’audio généré. La traduction utilise le même taux que l’export en MP3. La création de documents et l’export de fichiers ne consomment pas de crédits. La création de documents compte dans la limite quotidienne de documents de votre abonnement.
Consultez Ce qui utilise les crédits.