よくある質問
APIを使うには何が必要ですか?
Googleまたはメールアドレスでのアカウント作成が必要です。APIキーを取得し、リクエストヘッダーに「Authorization: Bearer <key>」を設定します。OpenAI SDKやcurlなどの標準的なHTTPクライアントを使って、エンドポイントにJSONボディを送信するだけで音声ファイルが生成されます。特別なSDKは不要です。
音声は誰の声をベースにしていますか?
LibriTTS-R(CC BY 4.0)およびLibriVoxの公衆ドメインオーディオブックの録音に基づいています。特定の有名人や著名人の声ではなく、ライセンスされた録音から生成された8種類のプリセット(Aria, Nova, Lunaなど)から選択します。カスタムボイスクローンは提供していません。
音声の品質はどの程度ですか?
クラウドAPIです。テキストは最大4096文字まで処理可能で、失敗したリクエストは無料です。音声は合成音声として生成され、リアルタイムに近い速度で出力されますが、負荷が高い場合はキューで待機する場合があります。
WordPressに直接組み込めますか?
公式のWordPressプラグインは提供していません。JavaScriptやPHPなどのフロントエンド・バックエンドコードからAPIエンドポイントを直接呼び出すことで、ブログ記事やWordPressサイトに音声読み上げ機能を組み込むことができます。OpenAI SDKや標準的なHTTPリクエストによる実装が必要です。
音声ファイルの形式は何がありますか?
mp3, wav, opus, flac, pcmの5つの形式から選択できます。ブラウザやプレイヤーとの互換性に応じて適切な形式を指定してください。デフォルトや制限なく、クライアント側の要件に合わせて出力形式を柔軟に設定できます。
音声の再生速度は変えられますか?
速度パラメータ(speed)で0.25から4.0の範囲で調整可能です。標準速度は1.0です。読み上げの速さを速めたり遅くしたりして、リスナーの好みに合わせて音声の再生速度を細かく制御することができます。
音声ファイルには著作権はありますか?
音声ファイルには合成音声を示す不可視のウォーターマークが含まれます。元ネタはLibriTTS-R(CC BY 4.0)やLibriVoxの公衆ドメイン素材です。カスタムクローンは提供していません。
音声にウォーターマークは入りますか?
はい、生成されたすべての音声ファイルには、合成音声であることを示す不可視のウォーターマークが入ります。これは音声の生成元が人工知能によるテキスト読み上げであることを示すためのものです。聴覚的にはほとんど気づきませんが、ファイルには埋め込まれています。
音声の言語は自動検知されますか?
言語パラメータ(language)を指定しない場合、テキストの文字(スクリプト)から推測されます。ラテン文字のテキストはデフォルトで英語として扱われるため、英語以外のラテン文字テキストの場合は明示的に言語コードを設定してください。
音声の生成にはどのくらい時間がかかりますか?
長いテキストでは約1秒あたり25文字の速度で生成されます。短い文章でも数秒かかります。リクエストは順番に処理されるため、負荷が高い場合はキューで待機する場合があります。リアルタイムに近い速度ですが、キュー混雑時は即時性に限界があります。
音声の読み上げエラーは発生しますか?
合成に失敗した場合、そのリクエストは無料となり料金は全額返金されます。テキストが4096文字を超えている場合、分割して処理する必要があります。ネットワークやサーバーの負荷により失敗することもありますので、エラーハンドリングを実装してください。
音声の読み上げで特定の単語を強調できますか?
SSMLやカスタム発音辞書、感情タグは提供していません。特定の単語を強調したり、発音をカスタマイズしたりする機能はありません。標準的な読み上げパラメータ(音声、速度、言語)のみで制御可能です。詳細な制御が必要な場合はテキスト側で工夫してください。
音声の読み上げで感情表現はありますか?
感情タグや感情表現の制御は提供していません。各音声プリセット(例:Novaは明るく、Lunaは柔らかい)のトーンは固定されています。特定の感情を指示して声色を変えることはできず、静的な音声特徴に基づいて生成されます。
音声の読み上げで複数の言語を混在させられますか?
1つのリクエストでは1つの言語(ISOコード)を指定します。複数の言語を混在させる場合は、言語ごとにテキストを分割して別々のリクエストを送信し、音声ファイルを結合する必要があります。自動検知に依存せず、明示的な言語指定を推奨します。
最初のリクエスト
curl
curl https://api.playh31.com/v1/audio/speech \
-H "Authorization: Bearer $TTS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"tts-1","voice":"aria","input":"Hello from the API.","response_format":"mp3"}' \
--output hello.mp3WordPress記事に音声を読み上げる方法
ブログ記事のアクセシビリティ向上に、WordPressプラグインに依存しない軽量なAPI導入をお勧めします。APIキーを取得後、OpenAI互換のSDKやHTTPリクエストで音声ファイルを取得し、記事に埋め込むだけで完了します。
複雑な設定不要で、フリーランスでもすぐに実装可能です。テキストを送信するだけで音声ファイルが返ってくるため、開発知識がなくてもブログの品質を上げられます。
APIキーの取得方法
サイト上部の「APIキーの取得」ページから、Googleまたはメールアドレスでアカウントを作成します。認証後、ダッシュボードでAPIキーを即時発行できます。
- Googleアカウントまたはメールアドレスでサインアップ
- APIキーは即時発行、旧キーは新キー発行と同時に無効化
- ダッシュボードで残高と使用量をリアルタイムで確認可能
WordPressプラグインなしでの導入
当APIは専用プラグインを提供していません。標準的なHTMLやJavaScript、またはPHPスクリプトでAPIエンドポイントにアクセスします。これにより、プラグインのバージョンアップに伴う互換性問題を回避できます。
OpenAI SDKのbase_urlを変更するだけで動作するため、既存のWeb開発スキルがそのまま活かせます。
- 標準的なHTTPリクエストまたはOpenAI互換SDKを使用
- プラグインの依存関係が不要で軽快な動作
- ブログのテーマや構成に影響を与えない実装
テキストの音声変換フロー
変換はシンプルです。POSTリクエストでテキストと音声設定を送信すると、音声ファイルが返されます。4096文字を超える場合は、クライアント側で分割して結合します。
生成は数秒から実時間程度で完了し、MP3やWAVなど必要なフォーマットで記事に組み込めます。
対応音声と言語のラインナップ
ブログやWordPress記事に多様な音声と言語を追加し、訪問者のアクセシビリティを向上させましょう。本APIは8種類の音声プリセットと23言語をサポートしており、フリーランスのコンテンツ制作に柔軟性を提供します。
単調な読み上げではなく、記事のトーンに合わせた声質を選べるため、読者体験を大きく向上させます。技術的な設定もシンプルで、即座に導入可能です。
8種の音声 presets
以下の8つの音声プリセットから、記事の雰囲気に最適な声を選択できます。女性の声では「aria」は暖かく明確なナレーター、「nova」は明るく活発、「luna」は柔らかく物語的な、「sage」は落ち着きのある説明用です。男性の声では「felix」はエネルギッシュなプロモーション、「milo」は親しみやすい対話型、「atlas」はニュートラルなニュース向け、「orion」は深みのあるドキュメンタリー調です。
- aria: 暖かみのある明確なナレーター
- nova: 明るく活発なトーン
- luna: 柔らかく物語的な語り口
- sage: 落ち着きのある説明用
- felix: エネルギッシュなプロモーション用
- milo: 親しみやすい会話型
23言語のサポート
英語、日本語、中国語、韓国語など23言語に対応しています。音声はどの言語でも使用可能ですが、非英語のラテン文字テキストには言語コードの指定が必要です。
対応言語はアラビア語、中国語、デンマーク語、オランダ語、英語、フィンランド語、フランス語、ドイツ語、ギリシャ語、ヘブライ語、ヒンディー語、イタリア語、日本語、韓国語、マレー語、ノルウェー語、ポーランド語、ポルトガル語、ロシア語、スペイン語、スワヒリ語、スウェーデン語、トルコ語です。ベトナム語やインドネシア語などは現時点で非対応です。
自動言語検知と指定
言語パラメータが未設定の場合、テキストの文字から言語が自動的に推測されます。ラテン文字のテキストはデフォルトで英語として処理されるため、他の言語の場合は明示的に language パラメータを設定してください。
フリーランス向けのコスト効率
フリーランスのブログ運営では、固定費を抑えつつ高品質な音声を提供できるかが重要です。当APIは文字数ベースの課金で、失敗したリクエストは返金対象となるため、リスクを抑えて導入できます。
クレジットカードやサブスクリプション契約が不要なため、複雑な請求書管理も不要です。USDTでのシンプルな支払いと、残金の永久有効により、コスト計算が明確になります。
文字数ベースの課金
100万文字あたり10ドル(1,000文字あたり0.01ドル)の従量課金です。スペースや句読点も含むため、正確なコスト計算が可能です。月額プランや最低利用額もないため、使用量に合わせた柔軟なコスト管理が可能です。
- 100万文字あたり10ドル
- 1,000文字あたり0.01ドル
- 月額プラン・最低利用額なし
失敗したリクエストは無料
音声合成に失敗した場合、そのリクエストの料金は全額返金されます。これは、生成コストの無駄を省き、正確な課金を実現する仕組みです。
USDTでのシンプルなお支払い
USDT(TRC-20)のみでのトップアップに対応しています。最小5ドルからのチャージで、送金後数分で残高に反映されます。カードやPayPal、請求書とは無縁な、フリーランスに最適なシンプルな決済フローです。残金は期限なく利用可能です。
サイトごとに独立したアカウントを持つため、他のユーザーとのコスト干渉はありません。
- USDT (TRC-20) のみ
- 最小チャージ額: $5
- 反映: 送金後数分
- 残金は期限なし
アクセシビリティと学習サポート
ブログ記事に音声を読み上げる機能は、視覚に頼らない情報アクセスを実現します。WordPressプラグインを追加せずAPIで導入できるため、既存のサイト構成を崩さずにアクセシビリティを向上させられます。
多言語対応と複数の音声スタイルにより、多様な読者層に配慮できます。音声ファイルはmp3やwavなど複数の形式で出力可能で、モバイル端末やアクセシビリティツールとの互換性も確保します。
視覚障害者への配慮
文字情報だけでなく音声も提供することで、視覚に障害のあるユーザーや、読み書きが苦手な方にもコンテンツを届けます。音声合成により、テキストを音声ファイルに変換できるため、ブログのアクセシビリティが向上します。
学習における音声活用
ブログ記事の音声を聴くことで、移動中や家事中に学習できます。8種類の音声スタイルから選べるため、学習効率やモチベーションを維持しやすくなります。音声は合成音声であるため、著作権の心配もありません。
多様なフォーマット出力
mp3、wav、opus、flac、pcmなどの形式に対応しています。用途に応じて最適な形式を選択でき、モバイル端末やアクセシビリティツールとの互換性を確保します。音声ファイルは生成時に返却され、サーバーには保存されません。
技術的な特徴と制限
このAPIはOpenAIのspeechエンドポイントと互換性があるため、既存のOpenAI SDKをbase_urlを変更するだけで簡単に組み込めます。WordPressプラグインに依存しないため、自由度の高いカスタマイズが可能です。
OpenAI SDKとの互換性
公式SDKのbase_urlをhttps://api.playh31.com/v1に変更するだけで、同じリクエスト形状で音声生成が可能です。これにより、開発者は複雑な独自実装を行わずに、既存のコードベースを最小限の変更で拡張できます。
レートリミットとキュー
APIキーあたり60リクエスト/分の制限があります(初回Top-up前は10リクエスト/分)。リクエストはキューに入って順次処理されるため、負荷が高い場合は生成に時間がかかる場合があります。
ストリーミング非対応
リアルタイムのストリーミングやWebSocketによる部分音声の受信はサポートしていません。テキストの音声変換が完了し、音声ファイルが生成されてから応答が返されます。

データの取り扱いとプライバシー
入力テキストは音声生成のみに使用され、訓練データには再利用されません。生成された音声ファイルはレスポンスとして返却されるだけで、サーバーには保存されません。
入力テキストの保存について
入力テキストは音声ファイルの生成にのみ使用され、モデルの改善や学習には利用されません。ただし、課金と請求の目的で、リクエストのメタデータ(時刻、文字数、ステータス)は保持されます。
生成音声のストレージ
生成された音声ファイルは、APIレスポンスを通じてクライアントに返却されますが、当社サーバー上には長期保存されません。生成後は直ちに廃棄されるため、音声データの蓄積リスクは最小限に抑えられています。
学習データへの利用
入力されたテキストは、音声生成のみに使用され、学習データとして利用されることはありません。ユーザーのコンテンツは完全に独立して処理され、第三者への提供や再使用の心配がありません。
サポートとお問い合わせ
私たちは電話やライブチャットを備えていないため、技術的な質問や課金に関するご相談はすべてメールにて承ります。迅速な対応を心がけていますので、必要な情報を明記してご連絡ください。
一般的な利用方法や仕様については、サイト内のFAQやドキュメントをご参照ください。複雑な技術要件でない場合は、まず自己解決を試みることを推奨します。
メールサポートのみ
カスタマーサポートはメールのみです。電話番号やライブチャットウィジェットは設置していません。
お問い合わせフォームまたは専用メールアドレスに、APIキー(末尾4桁)、発生時刻、エラー内容を送信してください。
営業日中に確認し、可能な限り早く返信いたします。
FAQでの自己解決
よくある質問セクションでは、APIキーの発行方法や基本的なcurlコマンドの例を解説しています。
レートリミットや文字数カウントの仕組みについても記載していますので、エラー回避の参考にしてください。
ドキュメントページで技術仕様を詳細に確認できます。
エラー時の対応
音声生成に失敗した場合、料金は全額返金されます。
500系エラーが発生した場合は、一時的なキュー混雑の可能性が高いです。少し待ってから再試行してください。
継続的なエラーや不明な点がある場合は、上記のメールサポートまでお気軽にお問い合わせください。
よくあるご質問
APIの利用資格、著作権、品質に関するよくある質問への回答です。技術的な正確さと実用性を重視し、フリーランスの皆さまの迷いを解消します。
明確な基準と制限を事前に把握することで、円滑な音声読み上げ体験を実現しましょう。
APIの利用資格
APIキーを取得すれば、WordPressプラグインなしでも誰でも利用可能です。Googleまたはメールアドレスでアカウントを作成し、APIキーを発行するだけで利用が始まります。
アカウントはサイトごとに独立しており、USDT(TRC-20)でのチャージが完了次第、すぐに利用可能になります。
- Googleまたはメール登録で即座にAPIキーを取得可能
- USDT(TRC-20)でのチャージは数分で反映される
音声の著作権
音声はLibriTTS-R(CC BY 4.0)およびLibriVoxの公衆ドメイン録音に基づいています。生成された音声ファイルには合成音声を示す不聴覚的透かしが埋め込まれています。
入力テキストは音声生成のみに使用され、学習データとしては再利用されません。
- CC BY 4.0およびパブリックドメイン由来の音声データを使用
- 生成音声には合成音声を示す透かしが埋め込まれている
音声の品質
音声はリアルタイムに近い速度で生成され、短くても数秒、長文ではテキスト1文字あたり約0.25秒の処理時間を要します。キューが混雑すると待ち時間が生じる場合があります。
ストリーミングやSSML、カスタム音声クローニングは非対応です。
8種のプリセット音声から選択でき、23言語で高品質な読み上げが可能です。
- リアルタイム生成だが、キュー混雑時は待ち時間が生じる場合がある
- ストリーミング、SSML、カスタム音声クローニングは非対応
はじめの一歩
ブログのアクセシビリティ向上は、まずAPIの動作確認から始めましょう。コードの書き出しがスムーズに行えれば、WordPress記事への音声統合も驚くほど簡単です。
公式ドキュメントは導入の王道です。ここでは具体的なcurlコマンド例やSDK連携の手順を学べます。実際の開発環境に合う形を確認してからAPIキーを取得しましょう。
デモを試す
まずはAPIキーなしで、または少量のトライアルクレジットで音声生成の挙動を確認できます。短いテキストでmp3やwavの出力品質を耳で確かめましょう。
音声のトーンや速度調整もここで試せます。WordPress記事に貼り付ける前に、好みの音声プレセットを見つけてください。
- mp3/wav形式で即座に音声ファイルが入手可能
- 8種類の音声プレセットから音色を選べる
- 速度0.25〜4.0まで細かく調整可能
ドキュメントを読む
技術的な詳細は/docs/ページに網羅されています。OpenAI互換のJSON body仕様や、エラーハンドリングの方法が丁寧に解説されています。
レートリミットや文字数制限のルールもここで確認できます。WordPressプラグインを使わない手動実装の場合でも、このドキュメントが最も頼りになる指南書です。
- OpenAI互換のAPIエンドポイント仕様
- エラー時のステータスコード一覧
- 主要言語のISOコード一覧
APIキーを生成
/get-api-key/ページでGoogleアカウントまたはメール登録を行い、APIキーを発行しましょう。キーは一つだけ有効で、新しいキーを発行すると旧キーは即時無効になります。
キーが発行されると、残高と使用状況がダッシュボードで確認できます。ここでcurlコマンドのサンプルも確認でき、そのままコピーしてテストできます。
- Googleアカウントまたはメールで即座に取得
- キー発行時に旧キーは自動的に無効化
- ダッシュボードで残高と使用履歴を確認
8つの音声を確認
以下の各サンプルは、同じ文章をこのAPIで生成したものです。 この方法により、ビジュアルエディタやブロックエディタから簡単に音声コンテンツを挿入でき、技術的な知識がなくてもブログ記事にアクセシビリティ機能を追加できます。
23言語
どの音声でも、これらの言語のいずれかを話します。
