SpeakNotesSpeakNotes
今すぐ始める

SpeakNotes APIドキュメント

SpeakNotes APIは、音声、動画、YouTubeリンク、ドキュメントを文字起こしや構造化された要約に変換します。OpenAPI 3.1仕様、エージェントスキルファイル、AIクライアント用のMCPサーバーを備えたREST APIです。

ベースURL

すべてのSpeakNotes APIリクエストは、HTTPS経由で単一のホストに送信されます。

https://api.speaknotes.io

認証

すべてのエンドポイントで認証が必要です。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はストリーミングHTTP上でModel Context Protocolサーバーを実行しているため、MCPクライアントは文字起こしや要約をツールとして呼び出すことができます。REST APIと同じベアラーAPIキーを使用します。

https://api.speaknotes.io/mcp

開発者向けリソース