よくある質問
テキスト読み上げAPIとは何ですか?
これはクラウドのテキスト読み上げAPIです。テキストを送信すると音声ファイルが返ります。公式SDKではなく、OpenAI SDKのbase_urlを「https://api.playaa999.com/v1」に変更して利用可能です。エンドポイントはPOST /v1/audio/speechでJSON形式のリクエストを送信します。医療チームが患者ガイドや内部文書を音声に変換するために設計されています。
音声はどのように生成されますか?
テキストをAPIエンドポイントに送信すると、音声ファイルが生成されます。最大4096文字のリクエストを送信し、音声、速度、フォーマットを指定します。音声はLibriTTS-RとLibriVoxの録音に基づいています。生成されたファイルには合成音声を示す不可視の透かしが含まれます。
医療現場でどのように使用されますか?
複雑な機器の説明や手順書を音声に変換し、現場での情報アクセスを向上させます。患者ガイドを音声コンテンツに変換して提供できます。8種類の音声プリセットから選べるため、医療チームが内部文書を迅速に音声化できます。
APIの速度は?
長文のテキストでは、生成速度は実時間に近い速度(1秒あたり約25文字)です。短いフレーズは数秒かかります。リクエストは順番に処理されるため、負荷が高い場合はキューで待機する場合があります。
音声の品質は?
8種類のプリセット音声(Aria, Nova, Luna, Sage, Felix, Milo, Atlas, Orion)から選択できます。各音声はライセンスされた録音に基づいています。23言語に対応し、音声は合成音声であることを示す透かしを持っています。
データは安全ですか?
入力テキストは音声生成のみで使用され、学習には使用されません。生成された音声はレスポンスで返され、保存されません。課金のためのメタデータ(時刻、文字数、ステータス)のみが保持されます。
カスタム音声は作成できますか?
いいえ、カスタム音声のクローニングは提供しておりません。既存の8種類のプリセット音声(Aria、Nova、Luna、Sage、Felix、Milo、Atlas、Orion)から選択してご利用ください。独自の音声をアップロードしたり、カスタムデザインを作成したりする機能はありません。
SSMLはサポートされていますか?
SSMLはサポートしていません。音声の制御には、音声プリセット、速度(0.25〜4.0)、言語コードなどのパラメータを使用します。カスタム発音辞書や感情タグ、音声のクローニング機能も提供していないため、シンプルで確実な音声生成が可能です。
ストリーミングはありますか?
ストリーミング、WebSocket、リアルタイムの部分的な音声は提供されていません。テキストを送信すると、音声ファイルが完全に生成され、レスポンスとして返されます。
エラーが発生した場合どうしますか?
合成に失敗した場合は、料金は全額返金されます。失敗したリクエストに対しては課金されません。APIはリクエストのステータスを返すため、必要に応じて再試行してください。
レートリミットは?
APIキー1つあたり1分間60リクエスト(初回チャージ前は10リクエスト)が制限です。1アカウントにつき1つのアクティブキーを持ち、再発行すると旧キーは即時無効になります。この60リクエストの制限は、キーの再発行やチャージ後も変更されません。
失敗したリクエストは課金されますか?
失敗したリクエストは無料です。合成処理が失敗した場合、料金は全額返金されます。したがって、課金されるのは正常に完了したリクエストのみです。音声ファイルが正常に生成され、レスポンスとして返された場合のみ、文字数に応じた料金が請求されます。
データは学習に使用されますか?
入力テキストは音声生成にのみ使用され、モデル学習には利用されません。生成された音声ファイルはレスポンスとして返され、サーバーには保存されません。課金処理のために、リクエストの時刻や文字数などのメタデータのみが記録されます。
サポートはありますか?
はい、メールサポートを提供しています。電話番号やライブチャットは用意していません。APIの利用に関する質問や技術的な問題がある場合は、お気軽にメールでご連絡ください。迅速に対応いたしますので、詳細な状況とエラー内容を含めてお知らせください。
テキスト読み上げAPIの仕組み
テキスト読み上げAPIは、指定されたテキストを入力として受け取り、音声ファイルを生成するクラウドサービスです。医療現場では、患者ガイドや内部文書を迅速に音声コンテンツに変換できます。APIエンドポイントhttps://api.playaa999.com/v1/audio/speechに対してJSON形式でリクエストを送信するだけで、音声合成が完了します。
テキストは最大4096文字まで送信可能で、それを超える場合は分割して処理されます。音声エンジンは指定されたモデルと音声プリセットに基づき、データを処理します。生成された音声ファイルは、MP3やWAVなどの形式でレスポンスとして返されます。
テキストの入力
APIへのリクエストには、inputフィールドに読み上げたいテキストを設定します。医療文書では、専門用語や数値を含む複雑なテキストも正確に処理されます。テキストは最大4096文字まで送信可能で、スペースや句読点も文字数にカウントされます。
音声エンジンの処理
リクエストを受信すると、音声エンジンは指定されたモデル(tts-1またはtts-1-hd)に基づきテキストを解析します。音声プリセット(aria、novaなど8種類)が選択され、音声の特徴が適用されます。処理は順番に行われ、キューに待機している場合は処理に時間がかかる場合があります。
音声ファイルの生成
処理が完了すると、音声ファイルが生成されます。response_formatパラメータでmp3、wav、opus、flac、pcmのいずれかを指定できます。生成された音声はレスポンスボディとして返され、ダウンロードまたはストリーミング再生に使用できます。各ファイルには合成音声を示す非可聴の透かしが埋め込まれます。
音声生成のプロセス
音声生成の核心は、適切なモデルと音声プリセットの選択にあります。tts-1とtts-1-hdは同じエンジンを使用し、価格も同一です。医療文書の性質に応じて、ariaやatlasなどのプリセットを組み合わせることで、患者向けガイドから専門的な機器の説明まで、適切なトーンを実現します。
生成された音声はmp3、wav、opus、flac、pcmの5つのフォーマットから選択可能です。医療現場のシステム要件に合わせて形式を指定し、迅速に音声コンテンツを統合できます。速度は0.25から4.0の範囲で調整可能で、複雑な手順書の理解を助けるために遅速を設定することもできます。
モデルの選択
APIはtts-1とtts-1-hdの2つのモデルを提供します。これらは同一の音声エンジンを使用しており、価格差もありません。医療チームの予算や品質基準に合わせて、どちらのモデルでも一貫した音声品質を得られます。
モデルの選択は音声の質に影響しますが、エンジンは共通です。そのため、特定の機能制限なく、テキストの長さや複雑さに対応した音声生成が可能です。
- tts-1とtts-1-hdは同じエンジンと価格
- 医療文書の要件に合わせた柔軟な選択
音声プリセットの設定
8種類の音声プリセットから、医療現場のニーズに合ったものを選定します。ariaは暖かく明確なナレーター、atlasは中立でニュース風のトーンを提供します。miloは会話的な親しみやすい音声で、患者とのコミュニケーションに適しています。
他のプリセットも用途に応じて使い分けられます。novaは明るく活発、lunaは柔らかく物語的な、sageは落ち着いた指示用、felixはエネルギッシュなプロモーション用、orionは深みのあるドキュメンタリー用です。これらはすべてライセンス付きの録音に基づくものです。
- aria: 暖かく明確なナレーター
- atlas: 中立でニュース風の音声
- milo: 会話的な親しみやすい音声
- nova, luna, sage, felix, orionも利用可能
フォーマットの変換
生成される音声ファイルは、mp3、wav、opus、flac、pcmの5形式から選択できます。医療システムの要件や、内部利用、配布目的に応じて最適な形式を指定します。mp3は保存容量を抑えつつ広く互換性があり、wavやflacは高品質な保存に適しています。
音声ファイルは生成直後にレスポンスとして返され、保存されません。必要な形式で即座に利用可能であり、医療チームのワークフローにスムーズに統合されます。
- mp3、wav、opus、flac、pcmから選択可能
- 用途に応じた最適な形式の指定

医療現場での適用
MediVoiceは、医療チームが患者ガイドや内部文書を迅速な音声コンテンツに変換するAPIです。テキストを送信するだけで音声ファイルが生成され、現場での情報アクセスを向上させます。
患者ガイドの作成
複雑な医療用語を含む患者向けガイドを音声に変換します。4096文字までのテキストを処理可能で、mp3やwav形式で提供されます。生成された音声ファイルには合成音声を示す不可聴の透かしが含まれます。
- 患者向け説明書の音声化
- 退院時の注意事項音声ガイド
- 服薬方法の説明音声
手順書の音声化
複雑な機器や手順書を音声で提供します。hands-freeでの情報アクセスを可能にし、現場での作業効率を向上させます。速度は0.25〜4.0で調整可能です。
- 手術器具の使用手順
- 緊急時のプロトコル音声
- 機器メンテナンス手順
多言語サポート
23言語に対応しており、任意の音声プリセットでどの言語でも話せます。日本語、英語、中国語など、多様な患者層に合わせた音声コンテンツを提供できます。
- 日本語、英語、中国語対応
- 言語指定による音声生成
- 多言語患者向けガイド
技術的な詳細
APIエンドポイントは POST https://api.playaa999.com/v1/audio/speech です。OpenAI SDKやcurlを使って、JSON形式でリクエストを送信します。
リクエストにはモデル、テキスト、音声プリセット、音声形式を指定します。認証はBearerトークンで行い、生成された音声ファイルがレスポンスとして返されます。
APIエンドポイント
音声生成の主要エンドポイントは POST https://api.playaa999.com/v1/audio/speech です。GET /v1/voices で利用可能な音声や言語、GET /v1/models でモデル情報を取得できます。
リクエストの構造
JSONボディには model(tts-1 または tts-1-hd)、input(最大4096文字)、voice、response_format、speed を含めます。language は任意で、日本語や英語などのISOコードを指定します。
認証には Authorization: Bearer tts-... ヘッダーを使用します。キーはアカウントごとに1つ有効で、発行時に古いキーは直ちに無効化されます。
- model: tts-1 または tts-1-hd
- input: テキスト(最大4096文字)
- voice: aria, nova, luna, sage, felix, milo, atlas, orion
- response_format: mp3, wav, opus, flac, pcm
- speed: 0.25〜4.0
- language: 任意のISOコード
レスポンスの処理
成功した場合、APIは音声ファイル(mp3など)を直接返します。失敗した場合は課金が返金されます。
生成された音声はレスポンスとして返され、サーバーには保存されません。入力テキストも音声生成のみで使用され、トレーニングには利用されません。
音声の品質
音声プリセットは8種類から選択でき、各ボイスに固有のトーンがあります。例えば、ariaは温かくクリアなナレーター向け、sageは落ち着いた教育的コンテンツに最適です。novaやfelixは活気があり、lunaやlunaは物語的な表現に適しています。
速度は0.25から4.0の範囲で調整可能です。生成速度はテキストの長さによりますが、短くても数秒を要します。SSMLや感情タグ、カスタム音声クローニングはサポートしていません。音声は自然なリズムで生成されますが、機械的な響きが残る場合があります。
音声プリセットの違い
8つのプリセットは、医療現場の文脈に合わせて選定できます。ariaは明確な説明に、atlasは中立的なニュース風トーンに適しています。
各音声はLibriTTS-RおよびLibriVoxの録音に基づいています。すべての音声は同じエンジンを使用し、言語に応じて最適化されます。
- aria: 温かくクリアなナレーター
- sage: 落ち着いた教育的トーン
- atlas: ニュース風の中立性
- nova: 明るく元気なトーン
- luna: ソフトな物語表現
- felix: エネルギーあふれる宣伝用
速度の調整
速度パラメータは0.25から4.0まで設定できます。これにより、患者の聴解力や専門家のニーズに合わせて調整可能です。
高速再生は情報伝達を効率的にしますが、音声の明瞭性が低下する場合があります。適切な速度設定が重要です。
- 最小速度: 0.25倍速
- 最大速度: 4.0倍速
- 推奨速度: 1.0〜1.5倍速
音声の自然さ
音声は自然なリズムで生成されますが、SSMLや感情タグはサポートしていません。音声に感情の変化や強調を細かく制御する機能はありません。
生成された音声には不可聴の透かしが埋め込まれており、合成音声であることが示されます。これは医療文書の信頼性を保つために役立ちます。
データの流れ
MediVoice JPのAPIは、医療文書の音声化を単純なデータフローで実現します。入力されたテキストは最大4096文字まで処理され、音声エンジンへ渡されます。
生成された音声ファイルは即座にレスポンスとして返され、サーバーには保存されません。メタデータのみが請求のために記録されます。
入力テキスト
患者ガイドや手順書などのテキストをJSONボディのinputフィールドに設定します。スペースや句読点も文字数としてカウントされます。
音声生成
APIは指定された音声プリセットと速度でテキストを処理します。生成はバックグラウンドで行われ、リクエストメタデータが記録されます。
出力ファイル
mp3やwavなどの音声ファイルがレスポンスボディに含まれて返されます。生成された音声は外部に保存されず、即時にダウンロード可能です。

統合の方法
医療チームの既存インフラにAPIを迅速に統合するための主要な3つの方法を解説します。OpenAI SDKの公式ライブラリ、簡易なcurlコマンド、またはカスタムアプリケーションからの直接通信が可能です。
それぞれの手法は、APIキーとエンドポイントの変更だけで動作します。これにより、複雑な独自SDKの導入なしに、患者ガイドや手順書の音声化を即時に開始できます。
OpenAI SDK
OpenAI SDK(公式ライブラリ)をそのまま利用可能です。base_urlをhttps://api.playaa999.com/v1に変更し、APIキーを設定するだけで動作します。PythonやNode.jsなどの既存コードを最小限の変更で統合できます。
- 既存のOpenAI互換コードを流用可能
- base_urlの書き換えのみで接続完了
- 公式ライブラリの安定した動作を保証
curlコマンド
開発環境やスクリプトでのテストに最適な方法です。POSTリクエストでJSONボディを送信し、音声ファイルを即座に取得できます。複雑な依存関係なしにAPIの挙動を確認できます。
- CLI環境での即時テストが可能
- 依存ライブラリ不要で軽量
- APIキーとモデル指定の明確な確認
カスタムアプリケーション
独自のUIやワークフローにAPIを埋め込む場合、標準的なHTTPクライアントを使用します。テキスト入力から音声ファイルの受信まで、アプリケーションのロジック内で直接処理できます。
- 既存のWebアプリや内部ツールへの埋め込み
- 任意のプログラミング言語で実装可能
- カスタムUIとのシームレスな連携
パフォーマンス
医療チームの音声コンテンツ作成において、生成速度と同時処理能力はワークフローの円滑化に直結します。テキスト読み上げAPIは、リクエストを順番に処理するため、負荷が高い環境ではキュー待ちが発生する可能性があります。
レートリミットはAPIキーごとに設定され、通常は1分あたり60リクエストです。最初の入金前は1分あたり10リクエストに制限されます。複数のキーを用いることで並列処理を可能にしますが、単一キーの上限は変更されません。
生成速度
長文のテキストでは、生成速度はほぼリアルタイム(約25文字/秒)です。短縮語句の生成には数秒を要します。
キューの処理
リクエストは順次処理されるため、負荷が高い場合はキューに待機することがあります。4096文字を超える場合は分割して結合します。
同時接続
1つのキーあたり1分あたり60リクエストの制限があります。最初の入金前は10リクエストです。キーを追加することで並列性は向上しますが、キーごとの制限自体は変わりません。
セキュリティ
医療現場のデータ保護は、信頼性の基盤です。入力テキストは音声生成にのみ使用され、トレーニングには利用されません。生成された音声はレスポンスとして返され、サーバーには保存されません。
請求のためのメタデータ(時刻、文字数、ステータス)のみが保持されます。これにより、監査が可能になり、透明性が保たれます。
データの暗号化
通信は標準的なHTTPSで保護されます。入力テキストは生成処理専用に使用され、トレーニングデータとして再利用されることはありません。生成音声は一時返送のみで、永続保存されません。
請求情報のみを記録することで、不要なデータの蓄積を防ぎ、プライバシーを尊重します。
APIキーの管理
アカウントにはアクティブなAPIキーが1つだけ割り当てられます。新しいキーを発行すると、古いキーは即時無効になります。これにより、鍵の紛失や不正利用時のリスクを最小限に抑えます。
キーは安全な場所に保管し、定期的な更新を推奨します。
- 1アカウント1アクティブキー
- 新キー発行で旧キー即時停止
- シンプルな権限管理
アクセス制御
APIキーはAuthorization: Bearerヘッダーで認証されます。キーを持つユーザーのみが音声生成リクエストを送信できます。外部への公開範囲は、キーの保管状況に依存します。
レート制限(60リクエスト/分)も攻撃緩和に寄与し、サービスの一貫性を保ちます。
トラブルシューティング
API利用中に遭遇する可能性のある一般的な問題と、その解決策を紹介します。
システムの状態を確認し、適切な対応を行うことで、円滑な音声生成を維持できます。
一般的な問題
音声生成に時間がかかる場合、キューが混雑している可能性があります。大量のリクエストが処理中であることを意味し、待機後に試してください。また、APIキーが期限切れまたは無効な場合、認証エラーが発生します。
テキストが4096文字を超える場合、音声ファイルが正しく生成されないことがあります。適切な分割が必要です。
- APIキーの無効化
- 文字数制限の超過
- キューの混雑による遅延
エラーの解決
失敗したリクエストは課金されません。レスポンスステータスコードを確認し、必要な修正を加えて再試行してください。速度パラメータが範囲外の場合、エラーが発生します。
ネットワークの問題が疑われる場合、APIステータスページを確認してください。
- ステータスコードの確認
- 再試行の推奨
サポートの連絡
電話やライブチャットはありません。サポートはメールのみです。
技術的な問題やアカウントに関する問い合わせは、指定されたサポートメール宛てに行ってください。返信には数日かかる場合があります。

将来の展望
MediVoice APIは、医療現場の多様なニーズに対応するために設計されています。現在サポートされている23言語と8つの音声プリセットは、患者ガイドから内部マニュアルまで幅広くカバーします。
将来の機能拡張については、特定のロードマップを提示していません。ただし、APIの柔軟性を維持し、医療チームの音声コンテンツ作成プロセスをさらに効率化するための改善を継続的に検討しています。
機能の拡張
現在のAPIは、テキスト読み上げに特化しています。SSMLやカスタム音声クローニング、ストリーミング機能は現在提供していません。
今後は、医療文書特有の用語処理や、より長いテキストの効率的な処理など、現場のワークフローに合わせた機能追加を検討しています。具体的な時期は未定です。
- SSMLやカスタム音声クローニングは現在非対応
- ストリーミング機能やリアルタイム出力も未提供
- 医療文書特有の処理ロジックの検討中
音声の改善
音声の品質向上は、基盤となっている音声プリセットの更新を通じて行われます。LibriTTS-Rのデータセットを活用した音声は、常に最新の基準に適合するよう調整されます。
速度の調整範囲(0.25〜4.0倍)や、音声の自然さは、現在のエンジン技術に基づいています。将来のエンジンアップデートにより、より滑らかな読み上げが可能になる可能性があります。
- 音声プリセットの定期的な品質調整
- エンジンエンジンのアップデートによる音声改善
- 速度調整の精度向上の可能性
新規言語の追加
現在サポートされている言語は23言語です。ベトナム語やインドネシア語、タイ語などは現在未サポートであり、将来の追加予定も特に明言していません。
医療現場での需要に基づき、必要な言語のサポートが検討される可能性があります。ただし、特定の言語の追加時期や保証はありません。
- 現在23言語をサポート(ベトナム語、インドネシア語は未サポート)
- 将来的な言語追加の可能性はあるが保証なし
- 医療現場のニーズに基づく言語サポートの検討
8つの音声を確認
以下の各サンプルは、同じ文章をこのAPIで生成したものです。 患者様の安全を最優先し、最新の医学知見に基づいた確かな情報提供に努めます
23言語
どの音声でも、これらの言語のいずれかを話します。
出典および参考資料
- Wikipedia
- Python documentation
- openai-python on GitHub
- W3C WAI: making audio and video accessible
- TRON developer hub: TRC-20
- IETF RFC 7845: Ogg Opus
- OpenAI API reference: create speech
- FFmpeg documentation
- LibriTTS-R paper (arXiv 2305.18802)
- MDN: Web Speech API
- Node.js documentation
- Creative Commons Attribution 4.0
