SpeakNotesSpeakNotes
Empezar
Plataforma de desarrolladores

La API, el servidor MCP y la plataforma OAuth de SpeakNotes

Convierte enlaces de audio, video y YouTube en transcripciones y resúmenes estructurados desde tu propio código, o deja que un agente de IA lo haga a través de MCP. Cada cuenta puede crear una clave y comenzar en el entorno de pruebas de forma gratuita.

  • Crea una clave tú mismo en el panel de control. Sin llamadas de ventas, sin listas de espera.
  • Las claves de entorno de pruebas devuelven resultados fijos, no consumen créditos y nunca afectan a tus notas reales.
  • Un servidor MCP alojado para que Claude, ChatGPT y Cursor puedan usar SpeakNotes de forma nativa.
Crear una clave APILeer el inicio rápido

Tres solicitudes para tu primer resumen

Comienza con una clave de entorno de pruebas para conocer las estructuras, luego cámbiala por una clave real cuando las respuestas se vean correctas.

  1. 1

    Crear una clave

    Abre Configuración, claves API y crea una. Elige el entorno de pruebas para probar cosas, o el entorno real para procesar audio real.

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

    Llamar a la API

    Envía la clave como un token de portador (bearer token). Los resúmenes, transcripciones y trabajos de YouTube responden en línea.

    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

    Subir archivos multimedia más largos

    Las subidas se ejecutan en segundo plano: crea la subida, realiza el PUT del archivo, complétalo y luego consulta la nota hasta que esté lista.

    # 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"

Lo que la plataforma te ofrece

Una API REST que lee y escribe

Enumera, crea, actualiza y elimina notas y carpetas. Transcribe audio, resume texto y resume enlaces de YouTube. Cada operación está en la especificación OpenAPI 3.1.

Un servidor MCP alojado

HTTP con streaming en api.speaknotes.io/mcp, con trece herramientas que cubren las mismas operaciones de lectura y escritura. Los agentes se conectan mediante OAuth o con una clave.

OAuth 2.1 con PKCE

Crea una aplicación que actúe en nombre de otros usuarios de SpeakNotes. El registro dinámico de clientes significa que un cliente MCP puede registrarse por sí mismo y conectarse sin que nadie tenga que pegar una clave.

Un entorno de pruebas real

Las claves que comienzan con sn_test_ ejecutan cada ruta, regla de validación y estructura de respuesta contra resultados fijos. Sin créditos, sin llamadas a modelos y las escrituras se guardan en una biblioteca de pruebas separada.

Créditos que puedes ver

Un crédito es un minuto de contenido multimedia iniciado. Cada respuesta que tiene un costo devuelve lo que se cobró y lo que queda, para que un agente pueda verificar antes de comenzar.

Credenciales con alcance limitado

Dale a una clave o a una aplicación solo lo que necesita. Una clave de solo lectura puede listar notas pero nunca eliminar una.

Precios

Cada cuenta recibe una asignación mensual de créditos que se reinicia. Las cuentas Pro reciben una cantidad mucho mayor. Además, los créditos son prepagados, por lo que un bucle de reintento descontrolado nunca podrá generar una factura inesperada.

60
créditos al mes en el plan gratuito
2,000
créditos al mes con Pro
Ver precios de los créditos

Referencia

Preguntas frecuentes de los desarrolladores

¿Es gratuita la API de SpeakNotes?
Cada cuenta recibe 60 créditos al mes sin costo, y las claves de sandbox son ilimitadas y gratuitas para siempre. Las cuentas Pro reciben 2,000 créditos al mes. Más allá de la asignación mensual, puedes comprar paquetes de créditos prepagados.
¿Cómo obtengo una clave de API de SpeakNotes?
Inicia sesión y abre Configuración, Claves de API. Tú mismo creas la clave y funciona de inmediato. No hay proceso de solicitud ni formulario de contacto.
¿Tiene SpeakNotes un entorno de pruebas (sandbox)?
Sí. Cualquier clave que crees con la opción de sandbox comienza con sn_test_. Ejecuta todas las rutas y devuelve resultados fijos y realistas sin llamar a un modelo, gastar créditos ni escribir en tus notas reales.
¿Cómo conecto SpeakNotes a Claude u otro cliente MCP?
Apunta el cliente a https://api.speaknotes.io/mcp a través de HTTP transmitible. Los clientes que admiten OAuth se registran solos y te piden autorización; los que no, pueden enviar una clave de API de SpeakNotes como token de portador (bearer token).
¿La API de SpeakNotes admite OAuth?
Sí. SpeakNotes ejecuta un servidor de autorización OAuth 2.1 con PKCE, rotación de tokens de actualización, registro dinámico de clientes y revocación. Los metadatos se publican en https://speaknotes.io/.well-known/oauth-authorization-server.
¿Cuáles son los límites de tasa de la API de SpeakNotes?
120 solicitudes de lectura, 30 solicitudes de escritura y 10 solicitudes de procesamiento por minuto, contadas por credencial. Cada respuesta incluye el presupuesto restante en sus encabezados de límite de tasa, y un código 429 te indica exactamente cuánto tiempo esperar.