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アカウントをお持ちのユーザーは、ウォレットとドキュメントライブラリを1つ共有します。APIは別の製品ではなく、追加の入り口にすぎません。

認証とドキュメント

各アカウントは、アプリ内の設定 → APIでAPIキーを作成します。キーは一度だけ表示され、サーバー側にはプレフィックスのみが保存されます。

すべてのリクエストに Authorization: Bearer sh_live_… を送信します。無効または取り消されたキーには 401 が返されます。

開発者向けドキュメントはヘルプセンターにあります。

• API概要（認証、制限、課金、べき等性）
• 実行中のOpenAPI契約は api.speechdash.com/v1/openapi.json

マーケティング向けの機能ページ Public API では、チーム内の非技術者向けにAPIの概要を説明しています。

課金の概要

アクション	クレジット
API経由でドキュメントを作成	0（プランのドキュメント上限にカウント）
音声を生成	クラウド再生と同じ：開始30秒ごとに0.5クレジット

音声リクエストは見積もりを保持した後、測定された再生時間で決済されます。再試行時には Idempotency-Key をドキュメント作成と音声生成に送信できるため、ネットワーク障害による二重請求を防げます。

レート制限はアカウント単位（キー単位ではない）で適用されます。レスポンスには標準のレート制限ヘッダーと、バックオフが必要な場合に Retry-After が含まれます。

5分で最初のリクエストを実行する

1. speechdash.comにサインインし、設定 → APIを開く
2. キーを作成してすぐにコピーする
3. API概要を読む
4. /v1/documents に短いテキストを POST するか、音声プリセットと言語を指定して /v1/audio/speech を呼び出す

最初は2文のサンプルから始め、その後で章全体をストリーミングします。概要ドキュメントには正確なフィールドとサンプルレスポンスが記載されています。

今後の展開

製品ニーズの拡大に伴い、APIも拡張されていきます。今すぐ統合する場合は、Discordで早期フィードバックに参加するか、契約に不明点がある場合はヘルプセンターを開いてください。

Speechdashを使用した製品開発ありがとうございます。皆さんが何を作り出すのか、楽しみにしています。

関連ガイド

• Public API 機能ページ
• Speechdashの始め方
• クラウド再生
• インポート形式
• クレジットの使用用途