设置
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桌面使用带有您个人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工具。对于这些路由和 /health，请使用REST。
信用额度
语音合成（REST和MCP）每开始生成30秒的音频会消耗 0.5 信用。翻译使用与MP3导出相同的计费方式。创建文档和文件导出不会消耗信用。创建文档会计入每日文档限额。
查看 信用使用情况。