Plataforma de desenvolvedor

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. 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. 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. 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.

60
créditos por mês no plano gratuito
2,000
créditos por mês com o Pro
Ver preços de créditos

Referência

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.