Speechdash 公開 API 現已上線
從您自己的應用程式呼叫 Speechdash。建立文件、使用與網頁應用程式相同的語音生成自然語音，並從現有的信用錢包計費。
Speechdash 公開 API 現已推出，網址為 api.speechdash.com/v1。如果您正在開發需要讓使用者聆聽文字的產品，現在可以無需開啟瀏覽器 UI，直接建立文件並生成語音。
本文將介紹已推出的功能、計費方式，以及如何在短短幾分鐘內完成首次 API 請求。
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。
五分鐘完成首次請求
- 登入 speechdash.com 並開啟 設定 → API
- 建立金鑰並立即複製
- 閱讀 API 總覽
- 將短文本
POST至/v1/documents，或使用語音預設與語言呼叫/v1/audio/speech
建議先用兩句範例開始，再嘗試串流整個章節。總覽文件中列出了精確的欄位與範例回應。
後續規劃
我們將隨產品需求擴展 API 功能。如果您今日開始整合，歡迎加入 Discord 提供早期回饋，或在說明中心詢問合約相關問題。
感謝與 Speechdash 共同開發。我們期待聽見您的作品！
相關指南
相關指南
在您的應用程式中呼叫 Speechdash。建立文件、用與應用程式相同的聲音生成自然語音，並從現有的信用錢包結算費用。
在行動裝置與桌面裝置上，透過雲端串流收聽自然流暢的文件語音。合成品質更佳、可跨裝置續聽，並快取句子以便匯出。
上傳 PDF、從網址匯入網頁內容，或直接貼上文字到你的圖書館。Speechdash 會自動偵測語言，並將文件準備好以供聆聽。
Speechdash pricing. Free includes 3 listening documents a day, 30-minute document uploads, and Eco listening on…