SpeakNotesSpeakNotes
시작하기

SpeakNotes API 문서

SpeakNotes API는 오디오, 비디오, YouTube 링크 및 문서를 전사본과 구조화된 요약본으로 변환합니다. OpenAPI 3.1 사양, 에이전트 스킬 파일 및 AI 클라이언트를 위한 MCP 서버를 갖춘 REST API입니다.

기본 URL

모든 SpeakNotes API 요청은 HTTPS를 통해 단일 호스트로 전송됩니다.

https://api.speaknotes.io

인증

모든 엔드포인트는 인증이 필요합니다. Bearer 토큰으로 SpeakNotes API 키를 보내거나, 로그인된 세션에서 호출하는 경우 Firebase ID 토큰을 보내십시오. 인증되지 않은 요청은 거부됩니다.

Authorization: Bearer YOUR_API_KEY

키 생성 및 취소는 설정, API 키. 에서 가능합니다. 로그인한 모든 사용자가 페이지를 볼 수 있지만, 키를 생성하려면 활성 Pro 플랜이 필요합니다.

엔드포인트

업로드 및 YouTube 작업은 비동기식으로 실행됩니다. 노트를 생성한 후 처리가 완료될 때까지 상태를 폴링하십시오.

  • GET/v1Describe the API
  • GET/v1/healthCheck the API is up
  • GET/v1/notesList notes
  • POST/v1/notesCreate a note from text
  • GET/v1/notes/{id}Get a note
  • PATCH/v1/notes/{id}Update a note
  • DELETE/v1/notes/{id}Delete a note
  • GET/v1/notes/{id}/statusGet processing status
  • GET/v1/notes/{id}/transcriptGet a transcript
  • POST/v1/notes/{id}/questionsAsk a question about a note
  • GET/v1/foldersList folders
  • POST/v1/foldersCreate a folder
  • GET/v1/folders/{id}Get a folder
  • PATCH/v1/folders/{id}Rename a folder
  • DELETE/v1/folders/{id}Delete a folder
  • POST/v1/uploadsStart a media upload
  • POST/v1/uploads/{id}/completeFinish an upload and start processing
  • POST/v1/transcriptionsTranscribe audio from a URL
  • POST/v1/summariesSummarize text
  • POST/v1/youtube-summariesSummarize a YouTube video
  • GET/v1/usageGet credit balance and usage

MCP 서버

SpeakNotes는 Streamable HTTP를 통해 Model Context Protocol 서버를 실행하므로, MCP 클라이언트는 전사 및 요약 기능을 도구로 호출할 수 있습니다. REST API와 동일한 Bearer API 키를 사용합니다.

https://api.speaknotes.io/mcp

개발자 리소스