A API, servidor MCP e plataforma OAuth do SpeakNotes
Transforme áudio, vídeo e links do YouTube em transcrições e resumos estruturados a partir do seu próprio código, ou deixe um agente de IA fazer isso através do MCP. Toda conta pode criar uma chave e começar no sandbox gratuitamente.
- Crie uma chave você mesmo no painel. Sem chamadas de vendas, sem lista de espera.
- Chaves de sandbox retornam saídas fixas, não consomem créditos e nunca tocam nas suas notas reais.
- Um servidor MCP hospedado para que Claude, ChatGPT e Cursor possam usar o SpeakNotes nativamente.
Três requisições para o seu primeiro resumo
Comece com uma chave de sandbox para aprender os formatos, depois troque por uma chave ativa quando as respostas parecerem corretas.
- 1
Crie uma chave
Abra Configurações, chaves de API e crie uma. Escolha sandbox para testar as coisas, ou live para processar áudio real.
# Any signed-in account can create one. Sandbox keys start sn_test_. open https://speaknotes.io/settings/api-keys
- 2
Chame a API
Envie a chave como um token bearer. Resumos, transcrições e trabalhos do YouTube respondem inline.
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
Faça upload de mídias mais longas
Uploads rodam em segundo plano: crie o upload, faça o PUT do arquivo, finalize-o e então monitore a nota até que esteja pronta.
# 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"
O que a plataforma oferece a você
Uma API REST que lê e escreve
Liste, crie, atualize e exclua notas e pastas. Transcreva áudio, resuma texto e resuma links do YouTube. Toda operação está na especificação OpenAPI 3.1.
Um servidor MCP hospedado
HTTP streamable em api.speaknotes.io/mcp, com treze ferramentas cobrindo as mesmas operações de leitura e escrita. Agentes se conectam via OAuth ou com uma chave.
OAuth 2.1 com PKCE
Crie um aplicativo que age em nome de outros usuários do SpeakNotes. O registro dinâmico de cliente significa que um cliente MCP pode se registrar e se conectar sem que ninguém precise colar uma chave.
Um ambiente de teste real
Chaves que começam com sn_test_ executam todas as rotas, regras de validação e formatos de resposta contra uma saída fixa. Sem créditos, sem chamadas de modelo, e as gravações vão para uma biblioteca de sandbox separada.
Créditos que você pode ver
Um crédito equivale a um minuto iniciado de mídia. Cada resposta que tem um custo retorna o valor cobrado e o saldo restante, para que um agente possa verificar antes de começar.
Credenciais com escopo
Dê a uma chave ou a um aplicativo apenas o que ele precisa. Uma chave de leitura pode listar notas, mas nunca excluí-las.
Preços
Cada conta recebe uma concessão mensal de créditos que é redefinida. Contas Pro recebem uma quantidade muito maior. Além disso, os créditos são pré-pagos, então um loop de repetição descontrolado nunca gerará uma fatura inesperada.
Referência
- Início rápidoDo zero a um resumo funcional, em curl.
- Autenticação e escoposChaves de API, chaves de sandbox, escopos e limites de taxa.
- OAuth 2.1Código de autorização com PKCE, registro dinâmico de cliente, atualização e revogação.
- Códigos de erroCada código que a API pode retornar e o que fazer em relação a cada um.
- Créditos e preçosQuanto custa cada operação e como recarregar.
- Especificação OpenAPI 3.1O contrato legível por máquina para cada operação.
- Manifesto MCPNome do servidor, transporte e lista de ferramentas em /.well-known/mcp.json.
- Arquivo de habilidade do agenteUm arquivo SKILL.md pronto para uso em runtimes de agentes.
Perguntas frequentes de desenvolvedores
- A API do SpeakNotes é gratuita?
- Cada conta recebe 60 créditos por mês sem custo, e as chaves de sandbox são ilimitadas e gratuitas para sempre. Contas Pro recebem 2.000 créditos por mês. Além da concessão mensal, você compra pacotes de créditos pré-pagos.
- Como obtenho uma chave de API do SpeakNotes?
- Faça login e abra Configurações, Chaves de API. Você mesmo cria a chave e ela funciona imediatamente. Não há processo de inscrição nem formulário de contato.
- O SpeakNotes possui um ambiente de sandbox?
- Sim. Qualquer chave que você criar com a opção de sandbox começa com sn_test_. Ela exercita todas as rotas e retorna uma saída fixa e realista sem chamar um modelo, gastar créditos ou gravar em suas notas reais.
- Como conecto o SpeakNotes ao Claude ou a outro cliente MCP?
- Aponte o cliente para https://api.speaknotes.io/mcp via Streamable HTTP. Clientes que suportam OAuth se registram e solicitam autorização; clientes que não suportam podem enviar uma chave de API do SpeakNotes como um token bearer.
- A API do SpeakNotes suporta OAuth?
- Sim. O SpeakNotes executa um servidor de autorização OAuth 2.1 com PKCE, rotação de token de atualização, registro dinâmico de cliente e revogação. Os metadados são publicados em https://speaknotes.io/.well-known/oauth-authorization-server.
- Quais são os limites de taxa da API do SpeakNotes?
- 120 solicitações de leitura, 30 solicitações de gravação e 10 solicitações de processamento por minuto, contadas por credencial. Cada resposta carrega o saldo restante nos cabeçalhos de limite de taxa, e um erro 429 informa exatamente quanto tempo esperar.