よくある質問
どの音声が一番英語学習に適していますか?
AriaやNovaは明確な発音で、Sageは指示的なトーンです。MiloやAtlasも会話やニュース形式として適しています。どの音声も23言語に対応しており、英語学習には特にクリアな発音の女性音声や、中立的な男性音声が推奨されます。特定の感情や強調は指定できませんが、速度調整でリズムを変えられます。
テキストを分割する際の注意点は何ですか?
1リクエストあたり最大4096文字までです。それを超える場合は、クライアント側で分割し、生成された音声ファイルを結合してください。各リクエストは独立して処理されるため、分割位置の前後で音声が途切れる可能性があります。文字数にはスペースや句読点も含まれるため、注意してカウントしてください。
APIのエラーはどのように記録しますか?
APIはエラー時にエラーコードを返します。失敗したリクエストは課金されません。また、リクエストのメタデータ(時刻、文字数、ステータス)は課金目的で保持されます。エラーログはクライアント側で記録し、必要に応じてサポートに問い合わせてください。電話サポートは存在しません。
生成された音声はファイルサイズが大きすぎますか?
ファイルサイズは選択したフォーマットに依存します。mp3は圧縮されており、opusも効率的です。wavやflacは高音質ですがファイルサイズが大きくなります。pcmは生データです。学習教材ではmp3かopusが推奨されます。音声は応答として返され、サーバーには保存されません。
音声の速度を変えると意味が変わりますか?
速度は0.25から4.0の範囲で調整できます。速度を変えても発音されるテキストの内容や意味は変わりません。単に再生速度が速くなったり遅くなったりするだけです。特定の単語の発音を変える機能や、感情の変化はサポートされていません。速度調整はリスニング練習の難易度調整に役立ちます。
APIはオフラインで使えますか?
APIはクラウドサービスのため、インターネット接続が必要です。POSTリクエストを送信してJSONボディを渡す必要があります。オフラインで使用することはできません。音声ファイルは生成後にクライアントに返されます。モバイルデバイスでもインターネット接続があれば利用可能ですが、専用モバイルSDKは提供されていません。
音声の著作権は誰にありますか?
音声はLibriTTS-R(CC BY 4.0)およびLibriVoxの公有書物読みに基づいています。生成された音声ファイルには合成音声を示す不可聴の透かしが含まれます。ただし、基盤となる録音のライセンス条件を確認してください。
APIのレスポンス時間はどれくらいですか?
長文ではリアルタイム速度(1秒あたり約25文字)で生成されます。短い文でも数秒かかります。リクエストは順次処理されるため、負荷が高い場合はキューで待機する場合があります。リアルタイムストリーミングはサポートされていないため、完了まで待ってから音声ファイルを取得してください。
音声ファイルの形式は何が推奨されていますか?
mp3またはopusが推奨されます。これらは圧縮されており、Webやモバイルでの再生に適しています。wavやflacは高音質ですがファイルサイズが大きくなります。pcmは生データです。英語学習教材では、mp3が最も一般的で互換性が高い形式です。
APIは複数人で使えますか?
アカウントあたり1つのアクティブなAPIキーのみが有効です。複数のユーザーが同じキーを使うことは技術的に可能ですが、レートリミット(1分間60リクエスト)が共有されます。別のキーを発行すると古いキーは即時無効になるため、同時使用には注意が必要です。
音声の品質はどのように保証されますか?
SLAや稼働率の保証はありません。音声はライセンスされた録音に基づいて生成されますが、特定の品質保証は提供されません。生成された音声には合成音声を示す透かしが含まれます。エラーが発生した場合は課金が返金されますが、品質のクレームに対する補償はありません。
APIは定期的に変更されますか?
モデルや音声の仕様は変更される可能性があります。ただし、既存のエンドポイント形状は維持される傾向があります。新しい機能やモデルが追加される場合がありますが、旧モデルの削除時期は未定です。変更がある場合はサイトで告知されます。互換性の保証はありません。
音声の生成に時間がかかることはありますか?
はい、負荷が高い場合はキューで待機する場合があります。通常はリアルタイム速度で生成されますが、サーバーの混雑状況により遅延が発生することがあります。ストリーミング機能がないため、生成完了まで待つ必要があります。短時間でも数秒かかる場合があります。
APIはモバイルデバイスで使えますか?
はい、HTTPリクエストを送信できるモバイルデバイスであれば使用可能です。専用モバイルSDKは提供されていませんが、OpenAI SDKや標準HTTPライブラリを使えます。mp3やopus形式の音声ファイルはモバイルアプリで再生可能です。インターネット接続が必要です。
音声の選び方
英語教材作成において、適切な音声選択は生徒の集中力維持に直結します。TTS APIの利用では、8種類の preset voice からコンテンツのトーンに最も適した声を選ぶことが重要です。特に女性声の ARIA と NOVA は、学習環境での使用頻度が高く、それぞれ異なる音声特性を持っています。
ARIAとNOVAの違い
ARIAは「温かくクリアなナレーター」の女性音声です。物語的な教材や、生徒の感情に寄り添う解説に適しています。対して NOVA は「明るく活発な」音声で、クイズやリズム感のあるリスニング教材に最適です。
- ARIA: 温かくクリアなナレーター
- NOVA: 明るく活発なトーン
男性音声の使い分け
男性音声は、ニュース風や対話形式の教材で威力を発揮します。ATLAS は「中立的でニュース風」、MILLO は「フレンドリーで会話風」です。FELIX の「エネルギッシュな」トーンはプロモーション動画や、活気あるクラス活動の音声素材として適しています。
- ATLAS: 中立的、ニュース風
- MILLO: フレンドリー、会話風
- FELIX: エネルギッシュ、プロモーション用
音声とコンテンツのマッチング
音声とテキストの整合性が学習効果を高めます。例えば、歴史の物語には ARIA や ORION(深みのあるドキュメンタリー風)が、日常会話の練習には MILLO が適しています。また、ALLISON のような特定のトーンではなく、8 preset voice の中から教材の性格に合った声を選ぶことが、生徒の理解を助けます。
スクリプトの準備
教材作成の第一歩は、APIが受け付ける正確なテキスト形式を整えることです。このAPIは1回のリクエストで最大4096文字まで処理可能ですが、空白や句読点も文字数としてカウントされるため、スクリプトの長さには細心の注意が必要です。
長文の教材を作成する際は、意味のある区切りでテキストを分割し、生成された音声ファイルを後で結合する戦略が有効です。これにより、音声の途切れを防ぎ、自然な流れを維持できます。
4096文字の制限
APIのエンドポイントは、1回のリクエストあたり最大4096文字のテキストを受け付けます。この制限は、生成の効率性と品質を保つための設計です。4096文字を超えるとエラーになるため、事前に文字数をチェックしてください。
テキストの分割戦略
長いスクリプトを処理するには、文や段落の区切りで分割し、個別に音声生成リクエストを送信します。生成された音声ファイルは、後で音声編集ソフトで結合できます。これにより、生成時間の短縮と、エラー時の部分再生が可能になります。
- 意味のある区切りで分割する
- 生成ファイルを安全に結合する
特殊文字の処理
英語の教材では、記号や数字、特殊文字が含まれることがあります。これらはすべて文字数にカウントされ、音声生成に影響を与える可能性があります。特に、読み上げが難しい文字列は事前に確認し、必要に応じてテキストを簡素化しましょう。
生成プロセス
APIキーを設定し、テキストを音声に変換する準備をします。
リクエストを送信し、生成された音声ファイルを受信します。
APIキーの設定
ダッシュボードから発行されたAPIキーをAuthorizationヘッダーに設定します。キーは1アカウントにつき1つで、新キー発行時に旧キーは即座に無効になります。
ヘッダーは Authorization: Bearer tts-... の形式で指定してください。
- AuthorizationヘッダーにBearerトークンを設定
リクエストの送信
POSTリクエストを https://api.woopwin.info/v1/audio/speech に対して送信します。JSONボディにはmodel、input、voiceなどを指定します。
テキストは1リクエストあたり最大4096文字までです。それを超える場合は分割して送信する必要があります。
- POST https://api.woopwin.info/v1/audio/speech
レスポンスの受信
リクエストが成功すると、音声ファイルがレスポンスボディとして返されます。失敗した場合は課金されません。
返された音声ファイルは、指定されたフォーマット(mp3、wavなど)で保存してください。
ファイルの処理
生成された音声ファイルは、mp3、wav、opus、flac、pcmの5つの形式で提供されます。授業で使用する環境に合わせて、適切な形式を選択しましょう。mp3は容量が小さく、Webでの配信に適しています。wavは編集ソフトでの扱いが容易です。
長いスクリプトを分割して生成した音声ファイルは、結合して一つの教材にまとめます。これにより、生徒が一貫性のある聴解教材をスムーズに学習できます。
フォーマットの変換
APIレスポンスで直接指定可能な形式はmp3、wav、opus、flac、pcmの5種類です。mp3はデータ容量が小さく、LMSやWeb教材へのアップロードに最適です。wavは音声編集ソフトとの互換性が高く、簡単な編集を加えたい場合に便利です。opusは高音質かつ低ビットレートで、帯域幅が限られる環境でも効率的です。
音声の結合
4096文字を超えるテキストは分割して生成するため、複数の音声ファイルになります。これらのファイルを音声編集ツールで連結し、一つのファイルにまとめましょう。これにより、生徒は途切れることなく教材を聴くことができます。結合時の無音部分や音量の統一にも注意してください。
- 分割ポイントでは文脈が途切れないように注意
- 結合後に音量レベルを統一
- 余計な無音部分を削除
品質の確認
生成された音声は、インビジュブルウォーターマークが埋め込まれており、合成音声であることが示されます。再生速度(0.25〜4.0倍)や発音の明瞭さを確認し、教材として適しているかチェックしましょう。速度調整は生徒の聴解レベルに合わせて調整できます。
ワークフローの構築
自動化されたワークフローにより、教材作成のスピードが向上します。APIをスクリプトに組み込むことで、手動での音声生成から解放され、効率的な作業が可能になります。
エラーログの記録は、生成失敗時の原因特定に役立ちます。また、生徒の反応をフィードバックとして収集し、音声の速度や内容の改善に継続的に反映させます。
スクリプトの自動化
PythonなどのスクリプトでAPIを呼び出し、テキストを自動的に音声に変換します。これにより、大量の教材を一括で生成でき、教師の負担を大幅に軽減します。
- PythonやNode.jsでAPIエンドポイントを呼び出す
- バッチ処理で複数のスクリプトを同時生成
- 生成完了後に自動でファイル名を付与
エラーログの記録
APIからのレスポンスコードをログとして保存します。レートリミット超過や一時的なエラー発生時にも、何が問題だったかを明確に把握できます。
失敗したリクエストの詳細を記録しておくことで、再試行ロジックの実装や、原因究明に役立てることができます。
- HTTPステータスコードの記録
- エラーメッセージのログ出力
- 失敗したリクエストのタイムスタンプ保存
フィードバックの反映
生徒からのフィードバックを収集し、音声の速度や音量を調整します。特定の音声で聞き取りにくい場合は、別の音声や言語設定を見直します。
収集したデータを元に、より効果的な教材を作成するための改善サイクルを回します。これにより、学習効率を継続的に向上させることができます。
- 生徒の聞き取り難易度のアンケート
- 音声速度の最適化データ収集
- 音声の選択に関するフィードバックの分析
トラブルシューティング
API利用時に遭遇しやすいエラーと解決策をまとめました。レート制限や一時的な遅延、音声の質に関する課題をすばやく特定し、教材作成のワークフローを中断させない方法をご紹介します。
レートリミットのエラー
キーあたりのリクエスト制限は通常60リクエスト/分ですが、初回利用時は10リクエスト/分に制限されます。一度上限に達すると、新しいキーを発行するまで制限が解除されません。バッチ処理を行う際は、4096文字ごとの分割回数を計算し、余裕を持ってスケジュールしてください。
- 初回制限:1分間あたり10リクエスト
- 通常制限:1分間あたり60リクエスト
- 制限解除:新しいAPIキーの発行が必要
タイムアウトの対処
短めのフレーズでも数秒、長いテキストではリアルタイムの生成速度(1秒あたり約25文字)がかかります。負荷が高い場合、リクエストはキューに入れられるため、応答が遅延することがあります。タイムアウトを感じたら、サーバー側の問題ではなく、生成待ちの状態であることを確認してください。
- 短文:数秒の生成時間
- 長文:約25文字/秒の生成速度
- 混雑時はキュー待機が発生
音声の質の問題
生成される音声には合成音声を示す不可視のウォーターマークが含まれます。これは正常な動作であり、品質の欠陥ではありません。音声の不明瞭さが気になるときは、速度を0.25〜4.0の範囲で調整するか、別の音声(例:ariaからnovaへ)を試してみてください。
- 不可視のウォーターマークが常時入り
- 速度調整(0.25〜4.0)で明瞭化
- 音声変更でトーンを調整
コスト管理
APIの利用コストを正確に把握し、予算を効率的に管理しましょう。
使用量のモニタリング
ダッシュボードで残高、トライアル期間、および残りの文字数を確認できます。
- 失敗したリクエストは課金されません。
トライアルの最大化
Googleサインインで0.50ドルのトライアルクレジットが提供されます。
- 有効期限は7日間です。
チャージのタイミング
TRONネットワーク(TRC-20)のUSDTで最小5ドルからチャージできます。
送金後、数分で残高に反映されます。

教材の配布
TTS APIで生成された音声教材を配布する際は、適切なファイル形式と共有方法が重要です。
著作権を明確に示し、生徒が synthetic speech であることを理解できるようにしましょう。
音声ファイルの共有
生成された音声ファイルは、直接リンクやクラウドストレージを通じて共有できます。
mp3やwav形式は広く対応しており、生徒が容易に再生できます。
著作権の明示
生成音声には不可視の透かしが入っており、合成音声であることが示されます。
教材配布時に「合成音声を使用」旨を明記すると、信頼性が高まります。
フォーマットの統一
クラス全体でmp3やflacなど統一された形式を使用することで、再生環境の差異を減らせます。
一貫したフォーマットは、学習者のストレスを軽減し、教材の品質を維持します。
生徒との活用
TTS APIを活用することで、生徒の聴解力を鍛えるための教材を素早く作成できます。特定のセリフを正確な発音で生成し、ワークシートと組み合わせることで、学習の質を向上させます。
速度調整機能を使えば、初心者向けのゆっくりした音声から上級者向けの自然な速さまで、難易度に合わせたカスタマイズが可能です。これにより、生徒の理解度に応じた効率的な学習体験を提供できます。
聴解教材の作成
スクリプトをAPIに送信するだけで、瞬時に音声ファイルが生成されます。4096文字までテキストを記述できるため、短い対話から短い物語まで柔軟に教材を作成可能です。生成された音声は、クイズやシャドーイング練習に直接利用でき、教師の準備時間を大幅に短縮します。
音声の速度調整
速度パラメータは0.25から4.0まで調整可能です。初級者には0.75倍などのゆっくりした速度を設定し、発音の細部まで聞き取れる環境を整えます。一方、上級者向けには1.0倍またはそれ以上の速度で、実際の会話に近いリズムの練習素材を提供できます。
多言語学習
23言語をサポートしており、英語だけでなく他言語の学習にも応用できます。特定の言語コードを指定することで、アクセントの異なる音声を作成可能です。例えば、英語学習の一環として、異なるアクセントの音声を用意することで、生徒の多様な聴解ニーズに応えられます。
教師間の共有
教師間でスクリプトやAPIリクエストのテンプレートを共有すれば、教材作成の標準化が進みます。同じ音声設定や分割ルールを共有することで、生徒が混乱せずに学習できます。
テンプレートの共有
APIキーの保存方法や速度設定をまとめたスクリプトテンプレートをチーム内で共有しましょう。これにより、新しい教師でも即座に高品質な教材を作成できます。
- JSONリクエストの例文
- 音声設定の標準値
ベストプラクティスの共有
4096文字の制限を避けるための分割戦略や、特定単語の読み方調整法を記録して共有します。失敗例から学ぶことで、効率的なワークフローが確立されます。
- 文字数制限の回避策
- 速度調整のヒント
コミュニティへの参加
他の教師と情報を交換し、新しい活用方法を発見しましょう。フィードバックを API 開発に反映させることで、教育現場に合わせた改善が進みます。
将来の計画
APIのアップデートは、モデルの改善や速度の向上を通じて、教材作成の質を段階的に高めていきます。現在の「tts-1」および「tts-1-hd」エンジンが基盤となり、より自然な音声提供を目指します。
現時点ではSSMLやカスタム音声クローニングは提供していません。安定したパフォーマンス維持を最優先します。
APIのアップデート
アップデートは既存のアクセスキーを引き継ぎます。互換性を保ちながら、生成品質の向上を行います。
新機能の期待
教師からの要望を基に、より実用的な機能を開発していきます。ただし、既存の8つの音声と23言語の枠組みを基本とします。
- 音声品質の微調整
- エラー処理の改善
フィードバックの反映
サポートメールを通じていただいた意見は、開発ロードマップに反映されます。具体的な使用例や課題を共有してください。
まとめと次のステップ
TTS APIは、教材作成の時間を大幅に短縮し、生徒の聴解練習を効率化します。4096文字までのテキストを変換でき、8種類の音声から選べる点は教師にとって有用です。
このガイドで学んだワークフローを試しに実装してみましょう。まずは短いスクリプトでAPIキーを試し、音声の質と速度を確認することが重要です。
APIの利点の再確認
無料トライアルで50,000文字のクレジットを受け取れるので、リスクなく始められます。USDTでのチャージは迅速で、月額課金も不要なため、予算管理がシンプルです。
- リアルタイムに近い生成速度
- 8種類の多様な音声
- シンプルなAPI仕様
最初のプロジェクトの開始
まずは1つのレッスン用スクリプトを作成し、APIで音声に変換してみましょう。生成された音声ファイルを生徒に配布し、フィードバックを集めるのがおすすめです。
4096文字を超える場合は、適切に分割して結合するワークフローを確立してください。
サポートへの連絡
技術的な問題やご質問がある場合は、メールサポートまでお気軽にお問い合わせください。
8つの音声を確認
以下の各サンプルは、同じ文章をこのAPIで生成したものです。 レート制限や一時的な遅延、音声の質に関する課題をすばやく特定し、教材作成のワークフローを中断させない方法をご紹介します。
23言語
どの音声でも、これらの言語のいずれかを話します。
