よくある質問
どの音声プリセットが出版に最適ですか?
『sage』は教育的な文脈に、「atlas」はニュースや報道に適しています。Narrative用途には「aria」や「luna」が推奨されます。8つのプリセットは全て多言語に対応しており、出版物のトーンに合わせて選択可能です。特定の感情表現タグは存在しないため、テキストの構成でニュアンスを制御してください。
音声ファイルのサイズを小さくするには?
response_formatで「opus」または「mp3」を選択してください。これらは可逆圧縮形式であり、ファイルサイズを効率的に削減します。対照的に「wav」や「flac」は無圧縮または可逆圧縮のためサイズが大きくなります。帯域幅を節約しつつ、必要な音質を維持するために適切なフォーマットを選択してください。
大量テキストの処理は可能ですか?
1リクエストあたり最大4096文字まで処理可能です。それ以上の長さのテキストは、クライアント側で4096文字ごとに分割し、生成された音声ファイルを結合する必要があります。生成速度は実時間程度ですが、負荷が高い場合はキューで待機する可能性があります。
OpenAI SDKとの互換性は完全ですか?
エンドポイントとJSONボディの形状はOpenAI Speechエンドポイントと同一です。base_urlをhttps://api.plays98.com/v1に変更し、APIキーを設定するだけで公式SDKが動作します。ただし、独自のSDKやSSML、ストリーミング機能は提供していないため、それらの機能は利用できません。
USDTでの支払いの利点は?
TRONネットワーク(TRC-20)のUSDTのみを受け付けます。最小5ドルからチャージ可能で、送金後数分で自動的に残高に反映されます。カードやPayPal、請求書、VAT付与がないため、企業会計における簡素なコスト処理に適しています。残高の有効期限はありません。
音声の速度は変更できますか?
speedパラメータで0.25から4.0の範囲で速度を調整できます。デフォルトは1.0です。これにより、聴取者の理解度やアクセシビリティ要件に合わせて、読み上げのテンポを最適化できます。速度変更は音声の質に影響を与えず、リアルタイムで適用されます。
多言語テキストの処理は正確ですか?
23言語に対応しており、どの音声でもこれらの言語を話せます。言語を指定しない場合、スクリプトに基づいて推測されます(ラテン文字は英語とみなされます)。非英語のラテン文字テキストでは、正確性を確保するためlanguageパラメータを明示的に設定してください。
音声のライセンスは問題ありませんか?
音声はLibriTTS-R(CC BY 4.0)およびLibriVoxの公有書物の録音に基づいています。生成される音声ファイルには合成音声を示す不可視の透かしが含まれます。これにより、音声の由来が明確になり、著作権やライセンスに関する懸念を軽減します。
エラー時の返金は自動ですか?
合成に失敗したリクエストについては、課金が完全に返金されます。失敗したリクエストには料金が発生しないため、信頼性の高い環境で運用できます。正常に完了したリクエストのみが課金対象となります。残高はリアルタイムで更新されます。
レートリミットを超過するとどうなりますか?
1分間あたり60リクエストの制限があります(初回チャージ前は1分間10リクエスト)。制限を超えると、リクエストはキューに入り、処理待ちになります。レートリミット違反によるペナルティや追加料金は発生しませんが、処理速度が遅くなる可能性があります。
音声の水印は聴取可能ですか?
生成された音声ファイルには不可視の透かし(watermark)が含まれています。これは人間の耳には聴こえず、音声の質に影響を与えません。透かしは音声ファイル内に埋め込まれており、合成音声であることを技術的に検証可能にします。
カスタム音声は作成できますか?
カスタムボイスクローニングや独自の音声アップロードは提供していません。8つのプリセット(aria, nova, luna, sage, felix, milo, atlas, orion)から選択してください。カスタム音声の設計や感情タグも現在サポートされていません。
APIのバージョン管理はどうなりますか?
現在はv1エンドポイントを使用します。モデルは「tts-1」または「tts-1-hd」の2種類です。バージョン管理に関する詳細な情報や後方互換性の保証は提供されていません。エンドポイントのパスはhttps://api.plays98.com/v1です。
サポートは迅速に対応してくれますか?
サポートはメールのみで行われます。電話番号やライブチャットは提供していません。迅速性の保証(SLA)やアップタイム保証もありません。技術的な質問や問題報告は、メール経由で対応チームに連絡してください。
音声合成の選択基準
出版業界における音声合成APIの選定では、音声の自然さと多言語対応範囲、および既存ワークフローとの統合容易性が重要です。Yomikaiは標準的なOpenAI互換エンドポイントを提供し、デジタル出版プロセスへのシームレスな組み込みを可能にします。
音声の質と自然さ
音声はLibriTTS-RおよびLibriVoxのライセンス済み録音に基づいており、各プリセットは明確な役割を持ちます。生成ファイルには合成音声を示す不可視の透かしが埋め込まれます。
- Aria: 暖かみのある明瞭なナレーター
- Luna: ソフトなストーリーテリング
- Atlas: ニュース向けのニュートラルなトーン
- Orion: ドキュメンタリー向けの深みのある声
多言語サポートの範囲
23言語(英語、日本語、中国語など)をサポートし、任意の音声で全ての言語を話せます。言語指定がない場合、文字コードから推測されますが、ラテン文字はデフォルトで英語とみなされるため、非英語の場合は明示的な指定が必要です。
ベトナム語やタイ語など、リスト外の言語は非対応です。
- サポート言語: 英語、日本語、中国語、ドイツ語など23言語
- 非対応: ベトナム語、タイ語、ウクライナ語など
APIの互換性と統合容易性
リクエスト形状はOpenAI Speechエンドポイントと同一です。ベースURLを変更するだけで、公式OpenAI SDKや既存のHTTPクライアントをそのまま利用できます。これにより、デジタル出版ツールへの統合コストが最小限に抑えられます。
認証はBearerトークンを使用し、60リクエスト/分のレートリミット内で効率的に処理されます。
- OpenAI互換エンドポイント: POST /v1/audio/speech
- SDK: 公式OpenAI SDKまたは標準HTTP
- 認証: Bearerトークンによる認証
実装ステップの解説
Yomikaiの音声合成APIは、既存のOpenAI互換エンドポイントを採用しており、出版ワークフローへの統合を簡素化します。まずhttps://api.plays98.com/v1のベースURLに対して認証キーを設定し、APIキーの取得とテスト環境の構築を行います。
APIキーの取得方法
サイト内の/get-api-key/ページでGoogleアカウントまたはメールアドレスとパスワードを使用して登録します。認証キーは1アカウントにつき1つまで有効で、発行すると旧キーは即座に無効化されます。
- Googleサインインまたはメールアドレス登録に対応
- キーは再発行により旧キーが即時無効化
curlコマンドでのテスト
POST https://api.plays98.com/v1/audio/speech に対してJSONボディを送信します。model、input、voiceパラメータを指定し、Authorizationヘッダーにキーを設定することで、音声ファイルを取得できます。
- エンドポイント: POST /v1/audio/speech
- リクエストボディ: model, input, voice
OpenAI SDKでの統合
公式OpenAI SDKのbase_urlを https://api.plays98.com/v1 に変更するだけで利用可能です。既存のPythonまたはNode.jsコードの修正のみで、Yomikaiの音声合成機能へ移行できます。
- base_urlの変更のみで動作
- 既存のOpenAI SDK互換性
音声プリセットの比較
Yomikaiは8つの音声プリセットを提供します。Aria、Nova、Luna、Sageは女性声、Felix、Milo、Atlas、Orionは男性声です。これらはLibriTTS-R(CC BY 4.0)の録音に基づいています。
各音声は特定の用途に最適化されており、出版コンテンツの性質に応じて選択できます。音声は合成音声であることを示す不可視の透かしを備えています。
女性音声:Aria, Nova, Luna, Sage
Ariaは明確なナレーター向け、Novaはアップビートなトーン、Lunaは物語語り、Sageは教育コンテンツに適しています。
これらの音声は、多言語(23言語)で話せます。言語を指定しない場合、ラテン文字は英語として扱われるため、非英語の場合は言語コードを明示してください。
- Aria: 暖かみのある明確なナレーター
- Nova: 明るく活気のあるトーン
- Luna: ソフトな物語語り
- Sage: 落ち着いた教育的トーン
男性音声:Felix, Milo, Atlas, Orion
Felixはプロモーション用、Miloは対話形式、Atlasはニュース向け、Orionはドキュメンタリー向けです。
各音声は特定のトーンと速度域で調整可能です。速度は0.25〜4.0で調整でき、難読症ユーザーの可読性向上に役立ちます。
- Felix: エネルギー満点なプロモーション
- Milo: 親しみやすい会話調
- Atlas: ニュースの中立なトーン
- Orion: ドキュメンタリーの深み
各音声の適した用途
各音声は、出版コンテンツの性質に応じて選択できます。例えば、教科書にはSageやAtlasが適しています。
音声は1リクエストあたり最大4096文字まで処理可能です。それ以上のテキストは分割して生成し、音声ファイルを結合します。
フォーマットと品質の選択
音声合成APIはmp3、wav、opus、flac、pcmの5つのレスポンスフォーマットに対応します。用途に応じて適切な形式を選択し、データ転送効率と品質のバランスを取ります。
各フォーマットは異なる圧縮特性を持ち、配信環境や保存要件に合わせて使い分けることが推奨されます。
MP3、WAV、OPUS、FLAC、PCM
mp3は圧縮形式です。wavは非圧縮、opusは可逆圧縮、flacはロスレス圧縮、pcmは生データを提供します。
ビットレートとファイルサイズの関係
ファイルサイズは生成された音声の長さとフォーマットに依存します。mp3はファイルサイズが小さく、wavは元の音声データを保持します。
ストリーミング非対応の理由
本APIはストリーミングやWebSocketを非対応としています。リクエストはバッチ処理され、生成完了後に音声ファイルが返されます。これにより、安定した音声品質を保ちます。
コスト最適化の戦略
音声合成APIのコスト構造は100万文字あたり$10(1文字あたり$0.00001)で算出されます。スペースや句読点も含む文字数を正確に把握することが、出版ワークフローにおけるコスト管理の第一歩です。4096文字ごとの分割処理において、不要な空白を除去する前処理を適用することで、余分な課金を回避できます。
APIは1分あたり60リクエストのレートリミットを適用します。大量のテキストを処理する際は、キュー管理が重要です。生成速度は実時間とほぼ同等(1秒あたり約25文字)であるため、バッチ処理を適切に設計することで、キュー待機時間を最小限に抑え、効率的な音声生成を実現します。
文字数カウントの効率化
課金は入力テキストの文字数に基づきます。半角スペースや改行コードもすべて「文字」としてカウントされるため、ソースデータから不要な空白を除去する前処理が有効です。特に、複数ページにわたる電子書籍のデータ処理では、これらの微小な文字数削減が累積的にコスト削減につながります。
失敗したリクエストは課金されません。ただし、正常に完了したリクエストに対しては、生成された音声ファイルのサイズや形式に関係なく、文字数分の料金が請求されます。したがって、入力テキストの精度を高めることが、コスト最適化に直結します。
バッチ処理によるキュー管理
APIはリクエストを順次処理します。短時間の大量リクエストはキューに溜まり、生成に時間がかかる場合があります。出版業界では、納期に合わせたバッチ処理が重要となります。1分あたり60リクエストの制限を超えないよう、スループットを調整してください。
長いテキストは4096文字ごとに分割し、音声ファイルを結合します。この際、分割点の選択が音声の自然さに影響します。意味的な区切りで分割することで、結合時の違和感を最小限に抑え、品質を維持しながらコスト効率を最適化できます。
USDTチャージのタイミング
残高はUSDT(TRC-20)のみでチャージします。最小チャージ金額は$5です。チャージはトランザクション確認後、数分で自動的に反映されます。月額プランやサブスクリプションがないため、必要な分だけチャージし、使い切った段階で再度チャージする柔軟な支払いモデルです。
残高は期限なしで維持されます。そのため、大規模なプロジェクトでは、事前に十分な残高を確保しておくことが推奨されます。また、APIキーの発行時に旧キーは即座に無効化されるため、チャージとキー管理を適切に同期させる必要があります。
アクセシビリティへの対応
Yomikai APIは、難読症やアクセシビリティ要件を持つ読者向けの音声生成に最適化されています。8種類の音声プリセットと広範な23言語のサポートにより、多様な学習ニーズに応えることができます。
速度調整機能(0.25–4.0倍速)を活用することで、ユーザー個々の聴解速度に合わせたカスタマイズが実現します。これにより、デジタル出版物のアクセシビリティ基準を確実に満たすことが可能です。
難読症ユーザー向けの音声設定
明確な発音を提供する「Aria」や「Sage」などの音声は、難読症ユーザーがテキストを正確に把握する際に有効です。特定の言語コードを指定することで、言語ごとの発音規則を正確に適用できます。
8種類の音声プリセットは、文脈に応じて使い分けることを推奨します。特に教育出版物では、一貫した音声品質が学習効果を高めます。
- 明確な発音特性を持つ女性・男性音声の選択
- 言語コードの明示的指定による発音精度の向上
- 8プリセットによる多様なトーンの実現
速度調整の活用方法
APIのspeedパラメータは0.25から4.0の範囲で調整可能です。速読可能なユーザーには高速設定を、ゆっくりと処理が必要なユーザーには低速設定を適用できます。
標準的な生成速度は約25文字/秒ですが、速度調整により聴取者の認知負荷を最適化できます。短めの文章では数秒、長文ではリアルタイムに近い速度で音声が発生します。
- 0.25〜4.0倍速の柔軟な速度調整
- ユーザーの聴解速度に合わせたカスタマイズ
- 標準速度は約25文字/秒
音声の明瞭性確保
音声データは合成音声であることを示す不可聴の透かしを内蔵しています。これにより、音声の真正性を保ちつつ、アクセシビリティツールとの互換性を確保します。
各音声プリセットは、教育やビジネス用途で明瞭性が重視されるよう設計されています。必要な場合は、音声の質を評価して最適なプリセットを選択してください。
- 合成音声を示す不可聴の透かし埋め込み
- 明瞭性を重視した音声プリセットの設計
- アクセシビリティツールとの互換性維持
データプライバシーの確保
Yomikai APIは、入力テキストを音声生成のみ目的として使用し、顧客の訓練データには一切利用しません。生成された音声ファイルはレスポンスとして返送された後、サーバー上に保持されません。これにより、出版物のコンテンツが外部に流出するリスクを最小限に抑えます。
入力テキストの使用方法
送信されたテキストは、指定された音声エンジンで音声ファイルに変換する処理にのみ使用されます。変換が完了すると、テキストは即時に破棄されるか、請求のために必要なメタデータ(時刻、文字数、ステータス)のみが保持されます。
生成音声のストレージ
生成された音声ファイルは、APIレスポンスを通じてクライアントに返送された後、永続的なストレージには保存されません。これにより、一意の音声データがデータベースに蓄積されることを防ぎ、プライバシー保護を徹底します。
トレーニングデータとの独立性
顧客が提供したテキストや生成された音声は、モデルの改善やトレーニングデータとして再利用されません。これにより、特定の出版物のコンテンツが将来のモデル更新に反映されることを防ぎ、知的財産の独立性を保証します。

エラーハンドリングの実装
出版ワークフローにおける音声合成APIの安定稼働には、レートリミットとキュー管理の正確な実装が不可欠です。YomikaiのAPIは1キーあたり1分間60リクエストの制限があり、初期は1分間10リクエストです。
レートリミットの監視
レートリミットを監視し、60リクエスト/分の上限に達する前にバックオフ処理を実装してください。これにより、不要なリクエストコストを削減できます。
失敗時の返金処理
音声合成に失敗したリクエストに対しては、課金が完全に返金されます。アプリケーション側でステータスコードを判定し、失敗時にログを記録するだけで、顧客への二重課金を防ぐことができます。
キュー待機のハンドリング
負荷時はリクエストがキューイングされ、処理まで待ち時間が生じます。短時間フレーズでも数秒、長時間テキストではリアルタイム速度(約1秒あたり25文字)で生成されるため、タイムアウト値を適切に設定してください。
サポートとトラブルシューティング
Yomikai APIの導入では、技術的な課題が予想されます。公式ドキュメントとメールサポートを活用し、エラーを迅速に特定・解決することで、出版ワークフローの安定性を確保します。
レートリミットやネットワーク遅延を考慮した設計により、長時間の音声生成でも品質を維持します。
APIドキュメントの参照
エンドポイントの仕様は /docs/ で確認できます。JSON形式のリクエストとレスポンス構造を正しく理解することが、統合の鍵です。
- POST /v1/audio/speech の仕様
- GET /v1/voices のレスポンス例
メールサポートの活用
技術的な不明点は email までご連絡ください。電話番号やライブチャットは提供していませんので、詳細なログ付きメールでの対応が最適です。
一般的なエラーの原因と解決
レートリミット(60リクエスト/分)超過時は、バックオフ処理を実装してください。キーの有効期限切れや文字数制限(4096文字)も原因となります。
- 429 Too Many Requests
- 401 Unauthorized
将来の展望
Yomikai APIの将来展望は、既存の安定した基盤を維持しつつ、出版ワークフローの効率性をさらに高める方向性を持っています。
APIの進化とアップデート
モデル「tts-1」および「tts-1-hd」のエンジンは現在も安定運用中ですが、バッチ処理におけるキュー管理の最適化により、長文テキストの生成速度が向上する可能性があります。
新言語の追加予想
現在の23言語リスト(アラビア語からトルコ語まで)に、ベトナム語やタイ語などのアジア言語が含まれていない点は今後の課題です。出版業界の多様化に対応し、既存の8音声でこれらをカバーする更新が期待されます。
出版業界へのさらなる貢献
アクセシビリティ要件の強化により、難読症ユーザー向けの速度調整機能や、MP3/FLACなどの多様なフォーマット出力が標準化されることで、デジタル書籍への統合がよりシームレスになるでしょう。
導入の決定要因
導入決定の根幹は、既存のデジタル出版ワークフローへのシームレスな統合能力です。標準的なOpenAI互換エンドポイントを採用することで、既存の基盤への追加投資を最小限に抑えられます。
コスト構造も明確です。文字数単位の従量課金制により、利用量に応じた適正な費用負担が可能です。
技術的適合性
標準的なOpenAI互換エンドポイントを採用することで、既存の基盤への追加投資を最小限に抑えられます。既存のデジタル出版ワークフローとの互換性が確保され、迅速な実装が可能です。
コスト効率性
文字数単位の従量課金制により、利用量に応じた適正な費用負担が可能です。失敗時の返金規定も存在し、無駄な支出を防げます。
アクセシビリティ要件
23言語と8種類の音声プリセットは、多様な読者層のニーズに対応します。速度調整機能により、難読症ユーザーへの配慮も可能です。
結論と推奨事項
Yomikaiは、標準的なOpenAI互換エンドポイントと8種類の音声プリセットにより、出版業界のアクセシビリティ要件に明確に適合します。複雑なカスタム音声クローニングやSSMLを必要とせず、既存のデジタル出版ワークフローにシームレスに統合可能です。
技術的には、60リクエスト/分のレート制限とUSDTによるチャージが、大規模なテキスト処理におけるコスト効率と安定性を保証します。トレーニングデータへの使用禁止は、著作権管理上の信頼性を高めます。
出版業界への適合性
23言語に対応し、難読症ユーザー向けの速度調整機能を提供します。入力テキストは生成のみで使用され、トレーニングデータには含まれないため、出版社のコンテンツ管理ポリシーと整合します。
失敗時の全額返金ルールは、テスト環境におけるリスクを最小限に抑えます。
- OpenAI互換の単純なAPI設計
- 23言語の広範なサポート
- トレーニング非使用のプライバシー保証
技術的優位性
公式SDKを使用せず、標準的なHTTPリクエストで実装可能であり、既存のシステムとの互換性が高いです。ストリーミングやSSML非対応は、バッチ処理における予測可能なコスト計算を可能にします。
生成音声には合成音声を示す不可視の透かしが含まれ、著作権上の明確性を確保します。
- 標準HTTPベースの統合
- 予測可能なバッチ処理コスト
- 合成音声の透かし埋め込み
導入の推奨ステップ
まず/get-api-key/でGoogleまたはメールアドレス登録を行い、APIキーを取得します。curlコマンドで音声生成をテストし、OpenAI SDKのbase_urlを書き換えて本番環境に統合します。
USDT(TRC-20)で最低$5からチャージし、レート制限(60req/min)を考慮したバッチ設計を行います。
- Googleまたはメールでアカウント作成
- curlまたはSDKでのテスト
- USDT(TRC-20)でのチャージ開始
8つの音声を確認
以下の各サンプルは、同じ文章をこのAPIで生成したものです。
23言語
どの音声でも、これらの言語のいずれかを話します。
出典および参考資料
- Wikipedia
- Python documentation
- curl documentation
- TRON developer hub: TRC-20
- openai-python on GitHub
- LibriVox public-domain audiobooks
- W3C WAI: making audio and video accessible
- openai-node on GitHub
- Creative Commons Attribution 4.0
- LibriTTS-R corpus (OpenSLR 141)
- OpenAI API reference: create speech
- IETF RFC 7845: Ogg Opus
