APIキーとMCP

APIキーを作成し、すべての公開RESTエンドポイントを呼び出し、公式のSpeechdash MCPサーバーに接続します。

設定 → APIを使用してキーを作成し、アシスタントを接続します。同じsh_live_…キーは公開REST APIと公式MCPサーバーを認証します。設定 → コネクタ下の接続器は異なる機能です：それらは第三者のMCPサーバーをアプリ内チャットに接続します。

キーの作成

設定 → APIを開きます。
新規キーをクリックし、名前を付け（例: Production server）、すぐにコピーします。プレフィックスのみが保存されます；フルセCRETは一度だけ表示されます。
サーバーからAuthorization: Bearer sh_live_…を送信します。ブラウザ、モバイルアプリ、または公開リポジトリにキーを入れることは決してありません。

最大10個のアクティブキーを保持できます。同じページから漏洩したキーを無効にできます。

GET /v1/meでキーを検証（メール、プラン、ウォレット）。ベースURL: https://api.speechdash.com/v1。

すべての公開HTTPルート：

メソッド	パス	目的
`GET`	`/health`	サービスの健康状態（APIキーなし；`/v1`の下にない）
`GET`	`/v1/openapi.json`	OpenAPI 3.1契約
`GET`	`/v1/me`	アカウント、プラン、ウォレット
`GET`	`/v1/documents`	ライブラリのドキュメントを一覧表示（完了したトランスクリプトを含む）
`POST`	`/v1/documents`	テキストドキュメントを作成（`source=api`）
`GET`	`/v1/documents/{document_id}`	ドキュメントとそのテキストを読み込み
`PUT`	`/v1/documents/{document_id}`	タイトル、テキスト、言語、`is_archived`、または`visibility`を更新
`DELETE`	`/v1/documents/{document_id}`	ドキュメントを削除
`POST`	`/v1/documents/{document_id}/translate`	新しい翻訳バージョン（MP3エクスポートと同じクレジット）
`GET`	`/v1/documents/{document_id}/export`	`pdf`、`docx`、`txt`、`csv`、`srt`、または`vtt`をダウンロード
`POST`	`/v1/audio/speech`	最大5,000文字の音声合成（JSON + 音声）
`POST`	`/v1/audio/stream`	WAVをストリーミング（最大20,000文字）
`POST`	`/v1/audio/stream/with-timestamps`	文ごとの音声とマーク付きのSSE
`GET`	`/v1/voices`	ボイスカタログ
`GET`	`/v1/voices/{voice_id}`	ボイスプリセット（例: `F1`）

APIは音声やビデオのトランスクリプションジョブを開始しません。完了したジョブはライブラリドキュメントとして表示されます（source=transcription）。インタラクティブなトライアウトページ：アカウント、ドキュメント、オーディオ、ボイス。

公式サーバーhttps://mcp.speechdash.com/mcpはライブラリまたは音声アクションごとに1つのツールを公開しています。ChatGPTはOAuthを使用します。CursorとClaude Desktopはストリーム可能なHTTPとあなたの個人APIキーを使用します。

MCPツール	REST
`speechdash_get_account`	`GET /v1/me`
`speechdash_list_documents`	`GET /v1/documents`
`speechdash_get_document`	`GET /v1/documents/{document_id}`
`speechdash_create_document`	`POST /v1/documents`
`speechdash_update_document`	`PUT /v1/documents/{document_id}`
`speechdash_translate_document`	`POST /v1/documents/{document_id}/translate`
`speechdash_export_document`	`GET /v1/documents/{document_id}/export`
`speechdash_delete_document`	`DELETE /v1/documents/{document_id}`
`speechdash_list_voices`	`GET /v1/voices`
`speechdash_get_voice`	`GET /v1/voices/{voice_id}`
`speechdash_synthesize_speech`	`POST /v1/audio/speech`

リソース: speechdash://openapi（ライブOpenAPI JSON）。

ストリーミング音声（POST /v1/audio/streamとPOST /v1/audio/stream/with-timestamps）にはMCPツールがありません。これらのルートと/healthについてはRESTを使用してください。

音声合成（RESTとMCP）は0.5クレジットを1回の30秒間の生成音声ごとに消費します。翻訳はMP3エクスポートと同じレートで消費します。ドキュメントの作成とファイルのエクスポートはクレジットを消費しません。ドキュメントの作成はプランの日次ドキュメント上限にカウントされます。