API の概要

Speechdash API を使用すると、アプリケーションと同じボイスでドキュメントを作成し、音声合成を行うことができます。API を通じて作成したものはすべて、ライブラリに表示されます。アプリ内で完了したオーディオおよびビデオのトランスクリプトは、ライブラリのドキュメントとして表示されます（source は transcription で、transcript_id が含まれます）。/transcripts の REST リソースは存在しません。ドキュメントのエンドポイントを使用してください。API はトランスクリプションのジョブを開始しません。

ベース URL:

https://api.speechdash.com/v1

ヘルスチェック（API キーなし）：GET https://api.speechdash.com/health

機械可読の契約書は https://api.speechdash.com/v1/openapi.json に公開されており、自社の言語向けのクライアントを生成できます。

エンドポイント

インタラクティブな OpenAPI ページ: アカウント, ドキュメント, オーディオ, ボイス。

MCP サーバー（AI アシスタント用）

Cursor、Claude Desktop、または他の MCP クライアントを使用している場合は、公式の Speechdash MCP サーバー を追加することで、HTTP を直接呼び出す代わりに使用できます。これは、同じライブラリ（完了したトランスクリプトを含む）、翻訳、エクスポート、ボイス、アカウントのスナップショット、およびストリーミング以外の音声合成を、同じ API キーと請求設定で提供するツールを公開します。ストリーミング音声は REST にとどまります。

MCP サーバーの フルツール一覧とセットアップ（stdio または Streamable HTTP）をご覧ください。また、AI システム向けの機械可読ドキュメントが掲載されている Agents hub もご覧ください。エンドユーザーは、このヘルプセンターの API キーと MCP から始めることができます。

API キーの作成

最大10個のアクティブなキーを保持でき、いつでも名前を変更でき、各キーの最後の使用日時を確認できます。キーを無効化すると、そのキーによるリクエストは即座に停止します。

リクエストの認証

キーをベアラー トークンとして送信します：

curl https://api.speechdash.com/v1/me \
 -H "Authorization: Bearer sh_live_your_key"

有効なキーがないリクエストは 401 で応答し、コードは unauthorized となります。

GET /me はアカウント ID、メールアドレス、プラン、ウォレット残高（wallet_cents と display_credits）、および使用された API キーのメタデータを返します。セットアップ後（例: Zapier で）キーの検証に使用できます。

POST /documents と POST /audio/speech はオプションの Idempotency-Key ヘッダーを受け付けます。同じキーと同じボディでリトライすると、24時間以内に最初の成功した応答が再生成され、ネットワークの一時的な不具合で2つ目のドキュメントが作成されるのを防ぎます。音声応答が保存できない場合、同じキーでリトライすると 409 が返され、再生成は行われず（元のリクエストは既に請求済み）、/audio/speech のクライアント切断は 204 で応答し、生成されたオーディオを決済し、キーを解放してリトライで再生成可能にします。ストリーミングオーディオエンドポイントはこのヘッダーを拒否します。

クレジット

音声合成はアプリと同じウォレットからクレジットを消費します：0.5 クレジット（1 ウォレットセント） が生成されたオーディオの開始した30秒ごとに費用となります。各リクエストは生成開始前に見積もり（小さなマージンを含む）を行い、実際に生成されたオーディオに基づいて決済されます。未使用の保留は返金され、各決済されたリクエストは 設定 → クレジット使用 に API 音声合成 として表示されます。API レスポンスの billed_credits フィールドはウォレットセント（2セント = 1 ディスプレイクレジット）です。ストリームが途中で中断された場合、既に配信されたセンテンスは請求されます。

ウォレット残高が保留をカバーできない場合、API は 402 で payment_required コードを返し、生成する前に応答します。

ドキュメントの作成はクレジットを消費しませんが、プランの日次ドキュメント制限（無料: 3件/日; Unlimited: 日次制限なし）およびアップロード時間制限にカウントされます。ファイルのエクスポートはクレジットを消費しません。

請求とインアプリ Cloud 再生

インアプリの Cloud 再生はドキュメントごとのセンテンスキャッシュを再利用します。サーバーで既に生成されたセンテンスを再生する場合、費用は 0 ディスプレイクレジット になる可能性があります。REST と MCP の音声エンドポイントは常に新しい音声を合成し、生成時に開始した30秒ごとに同じ率で請求されます。API または MCP の音声合成には再生キャッシュはありません。

制限

レート制限はアカウントごとにカウントされ、キーごとではないため、追加のキーはクォータを上げません。各応答には X-Request-ID が含まれ、 /documents と /audio/* は X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset も返します。サポートに連絡する際は X-Request-ID を引用してください。

音声リクエストには並列性の上限もあります。4つ目の同時リクエストは3つがまだ実行中の場合に 429 で応答し、1つの統合が合成を独占することを防ぎます。429 と 503 は Retry-After ヘッダー後にリトライできます。

音声合成の制限を超えるコンテンツがある場合は、ドキュメントを POST /v1/documents で作成し、アプリからその音声をエクスポートしてください。

ドキュメント: 共有、翻訳、エクスポート

シリアライズされたドキュメントには visibility と share_url（プライベートの場合は null）が含まれます。PUT /v1/documents/{id} は visibility を受け付け、読み取り専用の非公開ページを /share/document/{id} に公開し、また is_archived をアーカイブまたは復元することができます。共有ページはテキストのみです。有料のオーディオは再生されません。

POST /v1/documents/{id}/translate は新しい翻訳版を作成します。これは MP3 エクスポートと同じクレジットウォレット（開始した30秒ごとに0.5クレジット）を請求し、ウォレットが不足している場合は 402 を返し、翻訳が設定されていないかダウンしている場合は 503 を返します。

GET /v1/documents/{id}/export?format=pdf|docx|txt|csv|srt|vtt は現在のバージョンをアタッチメントとしてダウンロードします。PDF、DOCX、TXT、CSV に timestamps=1 を追加してセクションのタイムスタンプを含めます。SRT と VTT はトランスクリプトまたは完全なセンテンスのタイムスタンプが必要です。GET /v1/documents/{id} で保存された text はトランスクリプトのタイムスタンプヘッダーを保持します。それらを隠すことはアプリのリーダー設定のみです。

関連項目