よくある質問
どの音声を選択すべきか?
8つのプリセットから選定します。ariaは暖かく明確なナレーター、novaは明るく活発なトーンです。lunaは柔らかなストーリーテリング、sageは冷静な案内に適しています。男性ボイスでは、felixはエネルギッシュ、miloは親しみやすく、atlasはニュートラル、orionは深みのあるドキュメンタリー調です。用途に合わせて適切なトーンを選択してください。
どのフォーマットが最適か?
mp3、wav、opus、flac、pcmから選択可能です。mp3は容量が小さく汎用性が高く、wavは高品質な無圧縮形式です。opusは効率的な圧縮に向き、flacは可逆圧縮で品質を維持します。用途に応じて適切なフォーマットを選択し、APIリクエストのresponse_formatパラメータで指定してください。
多言語対応はどのようにするか?
23言語に対応しています。任意の音声でどの言語でも話せます。languageパラメータを指定しない場合、文字から言語が推測されますが、ラテン文字の非英語テキストでは英語と誤認識されるため、明示的にlanguageパラメータを設定してください。ベトナム語やタイ語などは未対応です。
テキストはどのように準備するか?
1リクエストあたり4096文字までです。それ以上の長文の場合は、複数のリクエストに分割して音声ファイルを生成し、それらを結合してください。スペースや句読点も文字数に含まれます。音声ガイドのセクションごとにテキストを区切り、適切な長さで分割して処理してください。
APIはどのように実装するか?
OpenAI SDKやHTTPクライアントを使用して実装します。base_urlをhttps://api.88rs.info/v1に変更し、AuthorizationヘッダーにAPIキーを設定してください。POST /v1/audio/speechエンドポイントにJSONボディを送信します。モデル、音声、フォーマット、速度を指定して音声ファイルを生成します。
音声ファイルはどのように管理するか?
生成された音声ファイルはレスポンスで返され、サーバーには保存されません。入力テキストも音声生成のみで使用され、トレーニングには使用されません。音声ファイルはクライアント側で管理し、必要に応じてローカルストレージやCDNに保存してください。メタデータは請求のために保持されます。
コストはどのように管理するか?
100万文字あたり10ドル(1000文字あたり0.01ドル)です。失敗したリクエストは無料です。TRONネットワークのUSDTで最小5ドルからチャージできます。残高は期限切れにならず、アカウントページで残高と使用状況を確認できます。Googleサインインで0.50ドルの試用期間があります。
品質はどのように保証するか?
LibriTTS-RおよびLibriVoxのライセンス済み録音に基づく音声を使用しています。生成されたファイルには合成音声を示す不可視の透かしが含まれます。SLAや稼働率保証はありませんが、失敗したリクエストは全額返金されます。音声の品質はプリセットごとに一貫しています。
パフォーマンスはどのように最適化するか?
1分あたり60リクエストのレート制限があります。短時間では数秒、長時間では実時間程度の生成速度です。リクエストはキューで処理されるため、負荷が高い場合は待機する可能性があります。並列処理を避け、リクエストを分散させてキュー待ちを最小限に抑えてください。
セキュリティはどのように確保するか?
APIキーはBearer認証で使用されます。アカウントごとに1つのアクティブなキーがあり、新しいキーを発行すると古いキーは即時無効になります。入力テキストはトレーニングに使用されず、生成音声はサーバーに保存されません。メタデータは請求目的のみで保持されます。
トラブルはどのように解決するか?
サポートはメールのみです。電話番号やライブチャットはありません。失敗したリクエストは自動的に返金されます。レート制限を超えた場合は、リクエストを間隔を空けて送信してください。APIキーの問題や請求に関する問い合わせは、アカウントページからメールでサポートチームに連絡してください。
将来の展望は何か?
現在の製品機能はリストされたもののみです。ストリーミング、SSML、カスタムボイスクローンは提供されません。独自のSDKやモバイルSDK、WordPressプラグインもありません。今後の機能追加や変更については、公式ドキュメントまたはお問い合わせページで確認してください。既存の機能に焦点を当てています。
音声の選択
APIを使用して音声ガイドを作成する際、まず適切な音声を選択します。女性音声は、博物館の展示解説や自然公園の案内に適しています。
女性の音声
ariaは温かく明確なナレーターとして、歴史的な背景を丁寧に説明する際に適しています。novaは明るく活気のあるトーンで、観光地の雰囲気を伝えるのに効果的です。lunaは柔らかく物語的なスタイルで、静かな博物館の展示解説に最適です。sageは落ち着いた指示口調で、経路案内やマナー説明に適しています。
- aria: 温かみのあるクリアなナレーター
- nova: 明るくアップビートなトーン
- luna: 柔らかく物語的なスタイル
- sage: 落ち着いた指示口調
男性の音声
男性音声は、ニュース風の情報提供やドキュメンタリー調の解説に使用されます。miloは親しみやすい会話調で、観光客との距離を縮める案内に適しています。atlasは中立的なトーンで、客観的な事実や時刻表の案内に向いています。
orionは深みのある声で、壮大な景観や歴史的な重みのある解説に使用されます。felixはエネルギッシュでプロモーション的な雰囲気を演出します。
- felix: エナジー満点なプロモーション
- milos: 親しみやすい会話調
- atlas: 中立なニュース調
- orion: 深みのあるドキュメンタリー調
音声の性格
各音声はライセンス付きの録音に基づいており、合成音声特有の無機質さを抑えています。生成される音声ファイルには、合成音声を示す不可視の透かしが埋め込まれます。
観光施設の特徴に合わせて、適切なトーンを選択することで、訪問者の理解と印象を向上させます。
フォーマットの設定
音声ファイルの形式を選択することで、配信環境や再生アプリとの互換性を最適化できます。各形式は特徴を持ち、適切な選択が音声ガイドの品質と効率に影響します。
MP3は汎用性が高く、WAVは高品質な録音に適し、Opusは帯域幅を節約します。利用目的に応じて適切な形式を選択してください。
MP3
MP3は最も広くサポートされている圧縮形式です。サイズが小さく、ネットワーク転送に最適です。多くのデバイスで再生可能です。
音声ガイドの配信に推奨されます。圧縮率に応じて品質を調整できます。
- 汎用的な互換性
- 小さなファイルサイズ
- 幅広いデバイス対応
WAV
WAVは非圧縮形式で、高音質が保たれます。データサイズが大きく、ストレージ容量に注意が必要です。
録音や編集用として適しています。音声ガイドのマスターコピーとして使用されます。
- 高音質
- 非圧縮
- 大きなファイルサイズ
Opus
Opusは効率的な圧縮を実現します。低帯域幅でも良好な音声品質を提供します。
モバイル環境での配信に適しています。データ通信量を節約できます。
- 高い圧縮効率
- 低帯域幅対応
- モバイル向け最適化
多言語対応
観光施設や博物館の音声ガイドでは、訪れる観光客の多様性に対応する必要があります。当APIは23言語に対応しており、単一のAPIキーで多言語コンテンツを効率的に制作できます。
23言語のリスト
対応言語はアラビア語、中国語、デンマーク語、オランダ語、英語、フィンランド語、フランス語、ドイツ語、ギリシャ語、ヘブライ語、ヒン디어、イタリア語、日本語、韓国語、マレー語、ノルウェー語、ポーランド語、ポルトガル語、ロシア語、スペイン語、スワヒリ語、スウェーデン語、トルコ語です。ベトナム語、インドネシア語、タイ語、ウクライナ語、ルーマニア語、チェコ語、ベンガル語などは未対応です。
どの音声でもすべての言語で話すことができます。言語を指定しない場合、文字から言語が推測されますが、ラテン文字の非英語テキストは英語とみなされるため、明確にするには明示的な指定が推奨されます。
- アラビア語、中国語、デンマーク語、オランダ語、英語
- フィンランド語、フランス語、ドイツ語、ギリシャ語、ヘブライ語
- ヒン디어、イタリア語、日本語、韓国語、マレー語
- ノルウェー語、ポーランド語、ポルトガル語、ロシア語、スペイン語
- スワヒリ語、スウェーデン語、トルコ語
言語の設定
リクエストボディにlanguageフィールド(ISOコード)を設定することで、音声の生成言語を明示的に指定できます。これにより、誤った言語推測を防ぎ、正確な発音を実現します。
例えば、オランダ語の観光地案内では、languageにnlを指定することで、自然なオランダ語の音声ガイドが生成されます。
音声の生成
指定された言語で、8つの音声プリセットのいずれかを使用して音声ファイルを生成します。各音声は特定の性格を持っており、ガイドの内容に合わせた選択が可能です。
生成された音声ファイルは、指定された形式で返却され、観光施設の音声ガイドシステムに直接組み込むことができます。
テキストの準備
観光施設の音声ガイド制作において、テキストの準備は生成品質を決定する最初のステップです。APIは1リクエストあたり最大4,096文字まで受け付けます。これを超える長い説明文や、施設全体を網羅するガイドテキストを処理する際には、適切な分割戦略が必須になります。
文字数制限を超えるとエラーになるため、事前にテキストを適切な長さに分割する必要があります。各パートは独立して音声ファイルとして生成され、最終的に単一の音声ファイルに結合されます。これにより、大量のテキストを効率的に処理できます。
文字数の制限
APIの仕様上、1回のリクエストで送信できるテキストの最大文字数は4,096文字です。スペースや句読点も含めてカウントされます。この制限を超えると、リクエストは失敗し、課金も発生しません。
テキストの分割
長いガイドテキストは、4,096文字ごとに複数のパートに分割してください。各パートは独立して音声ファイルを生成します。分割ポイントは、文の区切りなどを考慮し、自然な音声のつながりを維持するように調整してください。
音声の結合
分割して生成された複数の音声ファイルは、クライアント側またはサーバー側で結合する必要があります。これにより、単一の連続した音声ファイルが完成します。結合処理は、生成された音声ファイルのフォーマット(MP3、WAV、Opusなど)に合わせて行ってください。
APIの実装
API実装の中心は、テキストから音声ファイルを生成するエンドポイントです。リクエストボディには model("tts-1" または "tts-1-hd")を指定します。
エンドポイント
音声生成の主要エンドポイントは POST https://api.88rs.info/v1/audio/speech です。JSON形式でリクエストを送信し、音声ファイルを受け取ります。
パラメータ
リクエストボディには model("tts-1" または "tts-1-hd")を指定します。input には最大4096文字のテキストを、voice には8種類のプリセットのいずれかを設定します。response_format は mp3, wav, opus, flac, pcm から選択でき、speed は0.25〜4.0の範囲です。
エラー処理
合成に失敗した場合、課金は全額返金されます。APIキーはアカウントごとに1つ有効で、新しいキーを発行すると旧キーは即時無効になります。エラー時はレスポンスコードを確認し、適切な対処を行ってください。
レートリミットは1分間60リクエストです。これを超過するとエラーが発生するため、実装時にバックオフ処理を推奨します。
音声ファイルの管理
生成された音声ファイルは、APIレスポンスを通じて即時に取得されます。ファイルは外部ストレージに自動保存されず、クライアント側で管理する必要があります。これにより、データの有効期限やサーバー側の保管制限を気にせず、自由なアーカイブが可能です。
音声ファイルの管理は、プロジェクトごとの整理と検索効率を向上させます。メタデータを活用して、どのガイド音声か、どの言語で、いつ生成されたかを明確に記録してください。
保存場所
生成された音声はレスポンスボディとして返されるため、サーバーやクラウドストレージに保存する場合は、ご自身の環境(AWS S3、Azure Blob、ローカルディスクなど)に配置してください。当API側では生成後のファイル保持は行いません。
- レスポンス直後の保存が推奨されます
- 任意のストレージサービスで管理可能
ファイル名
ファイル名は自由ですが、ガイドの場所や音声の性格(例: aria, atlas)を含めると後々の管理が容易になります。拡張子は指定したフォーマット(mp3, wav, opus等)に合わせてください。
メタデータ
生成リクエスト時のパラメータ(モデル、音声、言語、速度)をメタデータとして記録しておくと、後の品質確認やバッチ処理で役立ちます。音声には合成音声を示す不可聴の水印が含まれますが、視覚的なメタデータは付与されません。
コスト管理
APIの利用コストは文字数に基づき算出されます。100万文字あたり10ドル(1,000文字あたり0.01ドル)が標準料金です。失敗したリクエストは課金されません。
使用量の追跡
ダッシュボードで残高、トライアル状況、生成済み文字数を確認できます。請求のためのメタデータは維持されますが、音声ファイル自体は保存されません。
トライアルの利用
Googleサインインで0.50ドルのトライアルクレジット(約5万文字)が7日間付与されます。メールアドレス登録ではトライアルは付きません。
トップアップ
TRONネットワーク(TRC-20)のUSDTのみで入金できます。最小5ドルから。入金後、数分で残高に反映されます。
- クレジットカードやPayPalは未対応です。
- 残高の有効期限はありません。
- サブスクリプションや月会費はありません。

品質保証
音声生成パイプラインの品質を保証するには、テスト環境での検証とエラー処理の確実性が不可欠です。APIからの応答ステータスを確認し、音声ファイルが正常に生成されたかを事前にチェックすることで、本番環境での不具合を未然に防ぎます。
ユーザーフィードバックは音声の質を継続的に改善するための重要な指標となります。生成された音声の明瞭さや感情の表現がガイドの目的に合致しているかを確認し、必要に応じて音声や速度のパラメータを調整します。
音声のテスト
APIエンドポイントにリクエストを送信し、ステータスコードが200であることを確認します。生成された音声ファイルの形式(mp3, wavなど)が正しく設定されているか、また音声の速度(speed)が意図した通りになっているかを検証します。
テキストの文字数が制限内(4096文字以下)であることを確認し、音声ファイルが正常に受信されたかを確認します。エラーが発生した場合は、エラーメッセージを確認して原因を特定し、必要に応じてテキストを調整します。
- ステータスコード200の確認
- 音声ファイル形式の検証
- 文字数制限のチェック
エラーの確認
APIからのエラーレスポンスをログに記録し、エラーの原因を特定します。例えば、無効なAPIキーや、サポートされていない言語が指定された場合のエラーを特に注意深く確認します。
エラーが発生したリクエストの詳細(リクエストID、タイムスタンプなど)を記録し、後でトラブルシューティングを行うためのデータを確保します。エラーが頻発する場合は、APIのレートリミットやサーバーの負荷状況も確認します。
- エラーレスポンスのログ記録
- エラー原因の特定
- リクエスト詳細の記録
ユーザーフィードバック
エンドユーザーからのフィードバックを収集し、音声の明瞭さや感情の表現が適切かどうかを評価します。特に、観光ガイドの文脈で音声が自然に聞こえているか、また情報が正確に伝わるかを重視します。
フィードバックを分析し、音声のパラメータ(voice, speed, languageなど)を調整する際の参考資料とします。フィードバックに基づいて音声の品質を継続的に改善し、ユーザー満足度を高めます。
- ユーザーフィードバックの収集
- 音声明瞭さの評価
- パラメータ調整の参考
パフォーマンス最適化
APIの利用効率を最大化するには、レートリミットの理解とキュー管理が不可欠です。1分間あたり60リクエストという上限を把握し、音声ガイドの大量生成における待ち時間を最小限に抑える設計を行ってください。
レートリミット
1つのAPIキーあたり1分間に60リクエストの制限があります。最初のトップアップ前までは1分間10リクエストのみです。この制限を超えるとエラーが発生するため、バッチ処理や適度な間隔を設けてください。
- 通常: 60 requests/min per key
- 未入金: 10 requests/min
- 超過時はエラー応答
キューの処理
リクエストは順次処理されます。負荷が高い場合、リクエストはキューに待機することがあります。特に長文のテキストを分割して生成する際は、前回の生成完了を待ってから次のリクエストを送信するのが確実です。
並列処理
公式SDKやHTTPクライアントを用いて、複数の音声生成リクエストを同時に送信することも可能です。ただし、並列数の増加はレートリミットに達しやすくなるため、適切なスロットリングを実装してください。
セキュリティ
観光施設の音声ガイド制作において、APIキーの安全な管理は基本です。当APIでは1アカウントにつき有効なキーは1つで、発行時に旧キーは即時無効化されます。必要に応じて新しいキーを都度発行できるため、万が一キーが漏洩した場合でも迅速に対応可能です。
データの取扱い 入力テキストは音声生成専用です。トレーニングデータには使用されず、生成音声もサーバーに永続保存されません。請求明細のため、リクエストの時刻や文字数、ステータスなどのメタデータのみが記録されます。音声ファイル自体はレスポンスとして返却されるのみで、サーバー側には残りません。
APIキーの管理
アクセストークンは「tts-」で始まる形式です。リクエストヘッダーにAuthorization: Bearer <キー>として設定してください。キーは秘密に保ち、ソースコードに直接埋め込む場合は注意が必要です。
キーは1アカウントあたり1つ有効です。新しいキーを発行すると、直前に使われていたキーは即時無効化されます。これにより、不正利用時のリスクを最小限に抑えることができます。
- キーは1つのみ有効
- 新発行で旧キーは即時無効化
- AuthorizationヘッダーにBearerトークンを設定
データの暗号化
通信はHTTPS経由で行われます。入力テキストは音声生成のためにのみ使用され、トレーニング目的での再利用はありません。生成された音声ファイルもサーバーには永続保存されず、クライアントに返却された時点で処理は完了します。
保存されるのは、請求計算のためのリクエストメタデータ(時刻、文字数、ステータス)のみです。これらは課金の正確性を担保するために必要不可欠な情報です。
アクセス制御
APIキー自体がアクセス制御の主要な手段となります。キーを持つリクエストのみが処理対象となります。また、1分あたりのリクエスト数制限(60リクエスト/分)により、過剰な使用や暴走ループからシステムを保護しています。
アクセスキーはサイトごとに独立しています。異なるサイトで作成したアカウントは互いに影響し合いません。これにより、複数のプロジェクトで異なるキーを安全に運用できます。
- APIキーによる認証
- レートリミットによる保護
- サイトごとの独立したアカウント管理
トラブルシューティング
API連携時に発生する一般的な障害を解決するための手順を解説します。音声生成の失敗や、予期せぬレスポンスがあった際の具体的な対処法を確認してください。
エラーの根本原因を特定し、迅速にサービスを再開するためのガイドラインです。
エラーコード
リクエストが失敗した場合、レスポンスボディにはエラー理由が返されます。認証エラーはAPIキーの確認を、レートリミット超過は60リクエスト/分の制限を確認してください。失敗したリクエストは課金されません。
- 401: 認証失敗
- 429: レートリミット超過
- 400: パラメータエラー
ログの確認
ダッシュボードの使用履歴から、失敗したリクエストのタイムスタンプと文字数を確認できます。これにより、特定のテキストや音声でエラーが再現するかどうかを判定できます。
サポートの依頼
技術的な問題やアカウントに関する問い合わせは、メールサポートのみ対応しています。エラーコードとリクエストIDを添えてご連絡ください。
将来の展望
今後のAPI更新では、生成エンジンの安定性向上とエンドポイントの最適化を行います。既存のtts-1およびtts-1-hdモデルの処理効率を改善し、テキスト読み上げ時のラグを最小限に抑えます。
APIの更新
リクエスト処理の高速化と、長文テキストの分割結合プロセスの安定化を図ります。これにより、多数の音声ガイドデータを連続生成する場合でも、一貫した品質を維持します。
音声の改善
既存の8つの音声スタイルの品質向上に注力します。
新しい機能
将来的には、より細かな制御や多言語対応の拡大を予定しています。
8つの音声を確認
以下の各サンプルは、同じ文章をこのAPIで生成したものです。 また、制作コストの抑制と、専門的なコンテンツにふさわしい音声の質を両立させることが、エージェントにとって重要な課題となっています。
23言語
どの音声でも、これらの言語のいずれかを話します。
