設定
API 金鑰與 MCP
建立 API 金鑰、呼叫所有公開 REST 端點，並連接官方 Speechdash MCP 伺服器。
使用 設定 → API 來建立金鑰並連接助手。相同的 sh_live_… 金鑰授權 公開 REST API 和 官方 MCP 伺服器。在 設定 → 連接器 下的連接器是不同的功能：它們將 第三方 MCP 伺服器附加到應用程式內的聊天。
建立金鑰
- 開啟 設定 → API。
- 點擊 新增金鑰，為其命名（例如
生產伺服器），並立即複製。僅儲存前綴；完整的祕密僅顯示一次。 - 從您的伺服器傳送
Authorization: Bearer sh_live_…。絕不在瀏覽器、行動應用程式或公開倉庫中放置金鑰。
您可以保留最多 10 個活動金鑰。從同一頁面撤銷泄漏的金鑰。
透過 GET /v1/me 驗證金鑰（電子郵件、計劃和錢包）。基礎 URL：https://api.speechdash.com/v1。
REST 端點
每個公開的 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）。互動式嘗試頁面：帳戶、文件、音頻、音頻庫。
MCP 工具
官方伺服器 https://mcp.speechdash.com/mcp 提供每個圖書館或語音動作的單一工具。ChatGPT 使用 OAuth。Cursor 和 Claude Desktop 使用帶有您個人 API 金鑰的可流式傳輸 HTTP。
| 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 工具。請使用 REST 來處理這些路徑，以及 /health。
信用額度
語音合成（REST 和 MCP）每開始 30 秒的生成音頻會消耗 0.5 信用額度。翻譯使用與 MP3 導出相同的速率。建立文件和檔案導出不會消耗信用額度。建立文件會計入您計劃的每日文件上限。
請參閱 信用額度使用說明。