SpeakNotesSpeakNotes
Commencer
Plateforme développeur

L'API, le serveur MCP et la plateforme OAuth de SpeakNotes

Transformez des liens audio, vidéo et YouTube en transcriptions et résumés structurés depuis votre propre code, ou laissez un agent IA le faire via MCP. Chaque compte peut créer une clé et commencer gratuitement dans la sandbox.

  • Créez vous-même une clé dans le tableau de bord. Pas d'appel commercial, pas de liste d'attente.
  • Les clés sandbox renvoient des résultats fixes, ne consomment aucun crédit et n'affectent jamais vos notes réelles.
  • Un serveur MCP hébergé pour que Claude, ChatGPT et Cursor puissent utiliser SpeakNotes nativement.
Créer une clé APILire le guide de démarrage rapide

Trois requêtes pour votre premier résumé

Commencez avec une clé sandbox pour comprendre les formats, puis passez à une clé réelle lorsque les réponses vous conviennent.

  1. 1

    Créer une clé

    Ouvrez les Paramètres, les clés API et créez-en une. Choisissez sandbox pour tester, ou live pour traiter de l'audio réel.

    # Any signed-in account can create one. Sandbox keys start sn_test_.
open https://speaknotes.io/settings/api-keys
  2. 2

    Appeler l'API

    Envoyez la clé en tant que jeton bearer. Les résumés, transcriptions et tâches YouTube répondent en ligne.

    curl -X POST https://api.speaknotes.io/v1/summaries \
  -H "Authorization: Bearer $SPEAKNOTES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "...your transcript...", "styleId": "meeting-notes"}'
  3. 3

    Télécharger des médias plus longs

    Les téléchargements s'exécutent en arrière-plan : créez le téléchargement, effectuez un PUT du fichier, terminez-le, puis interrogez la note jusqu'à ce qu'elle soit terminée.

    # 1. create the upload
curl -X POST https://api.speaknotes.io/v1/uploads \
  -H "Authorization: Bearer $SPEAKNOTES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fileName": "standup.m4a", "contentType": "audio/mp4"}'

# 2. PUT the file to uploadUrl, then complete it
curl -X POST https://api.speaknotes.io/v1/uploads/NOTE_ID/complete \
  -H "Authorization: Bearer $SPEAKNOTES_API_KEY"

# 3. poll until status is Done
curl https://api.speaknotes.io/v1/notes/NOTE_ID/status \
  -H "Authorization: Bearer $SPEAKNOTES_API_KEY"

Ce que la plateforme vous offre

Une API REST qui lit et écrit

Listez, créez, mettez à jour et supprimez des notes et des dossiers. Transcrivez de l'audio, résumez du texte et résumez des liens YouTube. Chaque opération est conforme à la spécification OpenAPI 3.1.

Un serveur MCP hébergé

HTTP diffusable sur api.speaknotes.io/mcp, avec treize outils couvrant les mêmes opérations de lecture et d'écriture. Les agents se connectent via OAuth ou avec une clé.

OAuth 2.1 avec PKCE

Créez une application qui agit pour d'autres utilisateurs de SpeakNotes. L'enregistrement dynamique des clients permet à un client MCP de s'enregistrer lui-même et de se connecter sans que personne n'ait à copier une clé.

Un véritable environnement de test (sandbox)

Les clés commençant par sn_test_ exécutent chaque route, règle de validation et forme de réponse par rapport à une sortie fixe. Pas de crédits, pas d'appels de modèle, et les écritures sont enregistrées dans une bibliothèque sandbox séparée.

Des crédits que vous pouvez suivre

Un crédit correspond à une minute de média commencée. Chaque réponse payante renvoie le coût facturé et le solde restant, afin qu'un agent puisse vérifier avant de commencer.

Identifiants à portée limitée

Donnez à une clé ou à une application uniquement ce dont elle a besoin. Une clé en lecture seule peut lister des notes sans jamais pouvoir en supprimer.

Tarification

Chaque compte reçoit une allocation mensuelle de crédits qui se réinitialise. Les comptes Pro en reçoivent une beaucoup plus importante. Au-delà, les crédits sont prépayés, de sorte qu'une boucle de nouvelle tentative incontrôlée ne pourra jamais générer de facture.

60
crédits par mois sur le forfait gratuit
2,000
crédits par mois avec Pro
Voir la tarification des crédits

Référence

Questions posées par les développeurs

L'API SpeakNotes est-elle gratuite ?
Chaque compte reçoit 60 crédits par mois gratuitement, et les clés sandbox sont illimitées et gratuites pour toujours. Les comptes Pro reçoivent 2 000 crédits par mois. Au-delà de l'allocation mensuelle, vous achetez des packs de crédits prépayés.
Comment obtenir une clé API SpeakNotes ?
Connectez-vous et ouvrez Paramètres, Clés API. Vous créez la clé vous-même et elle fonctionne immédiatement. Il n'y a pas de processus de demande ni de formulaire de contact.
SpeakNotes dispose-t-il d'un environnement de test (sandbox) ?
Oui. Toute clé que vous créez avec l'option sandbox commence par sn_test_. Elle exerce chaque route et renvoie une sortie fixe et réaliste sans appeler de modèle, sans dépenser de crédits et sans écrire dans vos notes réelles.
Comment connecter SpeakNotes à Claude ou à un autre client MCP ?
Pointez le client vers https://api.speaknotes.io/mcp via HTTP diffusable. Les clients qui prennent en charge OAuth s'enregistrent eux-mêmes et vous demandent de les autoriser ; les clients qui ne le font pas peuvent envoyer une clé API SpeakNotes en tant que jeton bearer.
L'API SpeakNotes prend-elle en charge OAuth ?
Oui. SpeakNotes exécute un serveur d'autorisation OAuth 2.1 avec PKCE, rotation des jetons de rafraîchissement, enregistrement dynamique des clients et révocation. Les métadonnées sont publiées sur https://speaknotes.io/.well-known/oauth-authorization-server.
Quelles sont les limites de débit de l'API SpeakNotes ?
120 requêtes de lecture, 30 requêtes d'écriture et 10 requêtes de traitement par minute, comptées par identifiant. Chaque réponse contient le budget restant dans ses en-têtes de limite de débit, et une erreur 429 vous indique exactement combien de temps attendre.