Fish Audio Docs
API リファレンステキスト読み上げ
Back to site

リアルタイム TTS

リアルタイムのテキスト読み上げの利用可能性と統合に関するメモ。

#リアルタイムTTS

リアルタイム TTS は、低遅延プレビュー、会話型再生、およびテキストを小さなチャンクで送信するアプリケーション向けです。Open API では、リアルタイムの可用性はアカウントの機能とロールアウト ステータスによって制御されます。運用トラフィックを構築する前に、アカウント チームと現在の GET /api/openapi.json スキーマが利用可能かどうかを確認してください。

## リクエスト

リアルタイム統合は、アカウントに対して有効になっている場合、WebSocket セッションを使用します。セッションでは引き続き同じ API キー認証が使用されます。

Authorization: Bearer FISHAUDIO_API_KEY

通常、クライアント イベントには、セッションの開始、テキスト チャンク、フラッシュ、および停止のセマンティクスが含まれます。 API キーをサーバーまたは信頼できるバックエンド コンポーネントに保存します。パブリックブラウザクライアントには配置しないでください。

## 応答

リアルタイム応答は、1 つの JSON ドキュメントではなく、ストリーミング イベントです。クライアントは、オーディオ チャンク、部分ステータス イベント、端末完了、および端末エラー イベントを処理する必要があります。セッションが失敗したときに再接続するか、非同期ジョブ にフォールバックするのに十分なローカル状態を保持します。

請求とクレジット

リアルタイム生成は、生成されたコンテンツ、セッション期間、または有効なモデルによって課金される場合があります。部分的な音声は切断前にすでに生成されている可能性があるため、中断されたすべてのセッションが空いていると想定しないでください。重要なセッションを プロフィール と調整します。

エラー

接続のセットアップ中に認証エラーが発生します。セッションエラーはイベントストリーム内で発生します。アカウントでリアルタイムが有効になっていない場合は、サポートされるサポートされるパスとして同期 HTTP または非同期ジョブを使用します。