SpeakNotes API、MCPサーバー、およびOAuthプラットフォーム
オーディオ、ビデオ、YouTubeリンクを文字起こしや構造化された要約に変換します。独自のコードから利用することも、MCPを通じてAIエージェントに実行させることも可能です。すべてのアカウントでキーを作成し、サンドボックスで無料で開始できます。
- ダッシュボードで自分でキーを作成できます。営業への問い合わせや順番待ちは不要です。
- サンドボックスキーは固定の出力を返し、クレジットを消費せず、実際のノートには一切影響しません。
- ホスト型MCPサーバーにより、Claude、ChatGPT、CursorがSpeakNotesをネイティブに使用できます。
3つのリクエストで最初の要約を作成
まずはサンドボックスキーで形式を確認し、レスポンスが適切であればライブキーに切り替えてください。
- 1
キーを作成する
設定の「API keys」からキーを作成します。試用にはサンドボックスを、実際の音声を処理するにはライブを選択してください。
# Any signed-in account can create one. Sandbox keys start sn_test_. open https://speaknotes.io/settings/api-keys
- 2
APIを呼び出す
キーをBearerトークンとして送信します。要約、文字起こし、YouTubeジョブはインラインで応答します。
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
長尺メディアをアップロードする
アップロードはバックグラウンドで実行されます。アップロードを作成し、ファイルをPUTし、完了させ、ノートが完成するまでポーリングします。
# 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"
プラットフォームでできること
読み書き可能なREST API
ノートやフォルダのリスト取得、作成、更新、削除が可能です。音声の文字起こし、テキストの要約、YouTubeリンクの要約も行えます。すべての操作はOpenAPI 3.1仕様に基づいています。
ホスト型MCPサーバー
api.speaknotes.io/mcp でストリーミング可能なHTTPを提供し、同じ読み書き操作をカバーする13のツールを備えています。エージェントはOAuthまたはキーを使用して接続します。
PKCE対応のOAuth 2.1
他のSpeakNotesユーザーの代わりに行動するアプリを構築できます。動的クライアント登録により、MCPクライアントはキーをコピー&ペーストすることなく、自己登録して接続できます。
本格的なサンドボックス
sn_test_ で始まるキーは、すべてのルート、検証ルール、応答形式を固定の出力に対してテストします。クレジット消費やモデル呼び出しは発生せず、書き込みは別のサンドボックスライブラリに行われます。
可視化されたクレジット
1クレジットはメディアの開始1分間に相当します。コストのかかるすべての応答には、消費量と残高が含まれるため、エージェントは開始前に確認できます。
スコープ付き認証情報
キーやアプリに必要な権限のみを付与できます。読み取り専用キーはノートのリスト取得のみを行い、削除はできません。
料金
すべてのアカウントに毎月リセットされるクレジットが付与されます。Proアカウントにはより多くのクレジットが付与されます。それ以降はプリペイド方式のため、再試行ループなどで請求額が膨れ上がることはありません。
リファレンス
- クイックスタートcurlを使って、ゼロから要約を作成するまで。
- 認証とスコープAPIキー、サンドボックスキー、スコープ、レート制限について。
- OAuth 2.1PKCE付き認可コード、動的クライアント登録、リフレッシュ、取り消しについて。
- エラーコードAPIが返す可能性のあるすべてのコードと、それぞれの対処法。
- クレジットと料金各操作のコストと、チャージ方法について。
- OpenAPI 3.1仕様すべての操作に関する機械可読なコントラクト。
- MCPマニフェスト/.well-known/mcp.json にあるサーバー名、トランスポート、ツールリスト。
- エージェントスキルファイルエージェントランタイム用のドロップインSKILL.md。
開発者からのよくある質問
- SpeakNotes APIは無料で使えますか?
- すべてのアカウントに毎月60クレジットが無料で付与され、サンドボックスキーは無制限かつ永久に無料です。Proアカウントは月間2,000クレジットが付与されます。月間付与分を超えた場合は、プリペイドのクレジットパックを購入してください。
- SpeakNotes APIキーはどうすれば取得できますか?
- サインインして「設定」から「APIキー」を開いてください。自分でキーを作成すればすぐに使用できます。申請プロセスや問い合わせフォームはありません。
- SpeakNotesにはサンドボックス環境がありますか?
- はい。サンドボックスオプションで作成したキーは sn_test_ で始まります。すべてのルートをテストし、モデルを呼び出したりクレジットを消費したり、実際のノートに書き込んだりすることなく、固定された現実的な出力を返します。
- SpeakNotesをClaudeや他のMCPクライアントに接続するにはどうすればよいですか?
- クライアントをストリーミングHTTP経由で https://api.speaknotes.io/mcp に向けてください。OAuth対応クライアントは自己登録して承認を求めます。非対応クライアントはSpeakNotes APIキーをBearerトークンとして送信できます。
- SpeakNotes APIはOAuthをサポートしていますか?
- はい。SpeakNotesはPKCE、リフレッシュトークンローテーション、動的クライアント登録、取り消し機能を備えたOAuth 2.1認可サーバーを運用しています。メタデータは https://speaknotes.io/.well-known/oauth-authorization-server で公開されています。
- SpeakNotes APIのレート制限はどのようになっていますか?
- 認証情報ごとに、1分あたり読み取りリクエスト120回、書き込みリクエスト30回、処理リクエスト10回です。すべてのレスポンスのレート制限ヘッダーに残りのバジェットが含まれており、429エラーが発生した場合は待機すべき正確な時間が示されます。