Speechdash 公共 API 现已上线

Speechdash 公共 API 现已在 api.speechdash.com/v1 上线。如果您构建的产品需要用户收听文本，您可以在无需打开浏览器 UI 的情况下创建文档并生成语音。

本文介绍了已发布的功能、计费方式以及如何在几分钟内完成首次请求。

API 当前功能

REST API 与您在应用中熟悉的听读功能保持一致：

• 在用户的 Speechdash 库中创建和管理文档（支持文本导入、标题和语言设置）
• 使用 Narrator、Questioner 和 Expert 语音预设在多种语言中生成语音
• 通过可预测的 JSON 端点列出、读取、更新和删除文档

通过 API 创建的文档会出现在 speechdash.com 的库中。您的用户可以继续在应用中收听、编辑文本、导出音频，或从其他设备继续操作。

语音合成使用与应用内播放相同的云端语音。使用量从账户的信用钱包中扣除，计费规则与产品中的云端收听一致。

适用场景

团队使用 API 的场景包括：在其他产品中集成收听功能

• LMS 和学习平台：为作业或文章添加朗读功能
• SaaS 工具中的无障碍层：为工具添加语音辅助功能
• 内部工具：批量导入内容供用户收听审核
• 原型开发：在完整 UI 发布前生成语音预览

如果您的用户已拥有 Speechdash 账户，他们将保留同一个钱包和文档库。API 是额外的入口，而非独立产品。

身份验证与文档

每个账户可在应用中 设置 → API 下创建 API 密钥。密钥仅显示一次；服务器仅存储前缀。

每个请求需在标头中发送 Authorization: Bearer sh_live_…。无效或已撤销的密钥将收到 401 响应。

开发者文档位于帮助中心：

• API 概述（身份验证、限流、计费、幂等性）
• 实时 OpenAPI 合约：api.speechdash.com/v1/openapi.json

面向团队非技术人员的营销功能页：公共 API。

计费概览

操作	信用消耗
通过 API 创建文档	0（计入套餐文档配额）
生成语音	与云端播放一致：每 30 秒音频 0.5 信用

语音请求预估使用量，随后结算为实际时长。重试时可在创建文档和生成语音时发送 Idempotency-Key，避免网络抖动导致重复扣费。

限流按账户（而非密钥）计算。响应中包含标准限流标头，并在需要时提供 Retry-After 指示。

五分钟完成首次请求

1. 登录 speechdash.com 并打开 设置 → API
2. 创建密钥并立即复制
3. 阅读 API 概述
4. 向 /v1/documents 发送 POST 请求或调用 /v1/audio/speech，附带语音预设和语言参数

先用两句话的样本测试，再逐步处理完整章节。概述文档列出了具体字段和示例响应。

后续计划

随着产品需求增长，我们将持续扩展 API。如果您今天集成，欢迎加入 Discord 提供早期反馈，或在文档不明确时查阅帮助中心。

感谢与 Speechdash 共同构建。我们期待听到您的产品成果。

相关指南

• 公共 API 功能页
• Speechdash 快速入门
• 云端播放
• 导入格式
• 哪些操作消耗信用