よくある質問
どの音声スタイルがSaaS通知に適していますか?
SaaS通知には、aria(ナレーター)またはsage(インストラクショナル)が適しています。ariaは明確で、sageは冷静な指示に適しています。また、felixはプロモーション向け、miloは会話的な通知に適しています。用途に合わせて8種類のプリセットから選択可能です。
OpenAI SDKはどのように設定しますか?
base_urlを https://api.criex.info/v1 に変更し、APIキーを設定するだけで利用可能です。エンドポイントはOpenAIのspeechエンドポイントと同一です。他のSDKも同様にbase_urlを書き換えることで、そのまま統合できます。
USDTでの.topアップは安全ですか?
TRONネットワーク(TRC-20)のUSDTのみに対応しています。最小5ドルからトップアップ可能で、送金後数分で自動的に残高に反映されます。クレジットカードやPayPal、請求書は提供していません。残高の有効期限はありません。
4096文字を超えるテキストはどのように処理しますか?
4096文字ごとにテキストを分割し、それぞれを音声合成します。その後、生成された音声ファイルを結合します。これにより、長いテキストでも正確に音声化できます。
失敗したリクエストは課金されませんか?
はい、合成に失敗したリクエストは無料です。課金は成功した場合のみ行われ、失敗した場合は課金が全額返金されます。これは失敗したリクエストに対してのみ適用されるルールです。
どのフォーマットがブラウザで再生可能ですか?
mp3、wav、opus、flac、pcmの5つのフォーマットから選択できます。mp3、wav、opus形式は主要なブラウザでネイティブに再生可能です。
言語自動検出は正確ですか?
言語が設定されていない場合、スクリプトに基づいて推測されます。ラテン文字のテキストはデフォルトで英語として扱われます。非英語のラテン文字テキストでは、明示的にlanguageパラメータを設定することを推奨します。
レートリミット超過時はどうなりますか?
1分あたり60リクエスト(初回トップアップ前は10リクエスト)が制限です。超過するとリクエストがキューに積まれ、順番に処理されます。リクエストは逐次処理されるため、負荷が高い場合は待機が発生します。
音声の透かしは聞こえますか?
生成される音声ファイルには、合成音声であることを示す不可聴の透かしが埋め込まれています。これは人間の耳には聞こえないレベルの透かしであり、音声の品質や再生には影響しません。
音声データはトレーニングに使われますか?
入力テキストは音声生成のみのために使用され、トレーニングには利用されません。生成された音声はレスポンスで返され、保存されません。請求のためのメタデータ(時間、文字数、ステータス)のみが保持されます。
モバイルアプリでこのAPIは使えますか?
公式のモバイルSDKは提供していません。しかし、OpenAI SDKや通常のHTTPリクエストを使用することで、モバイルアプリからAPIを統合可能です。base_urlを変更するだけで利用可能です。
WordPressで音声読み上げ機能を実装できますか?
公式のWordPressプラグインは提供していません。しかし、APIエンドポイントにHTTPリクエストを送ることで、WordPressに音声読み上げ機能を独自に実装することは可能です。カスタム開発が必要です。
音声のライセンスは商用利用可能ですか?
音声はLibriTTS-R(CC BY 4.0)およびLibriVoxのパブリックドメインのオーディオブック読みに基づいています。商用利用は可能です。ただし、音声自体のライセンスと、生成された音声ファイルの利用条件は別です。
サポートはメールのみですか?
はい、サポートはメールのみです。電話番号やライブチャットは提供していません。質問や問題がある場合は、メールでサポートチームに連絡してください。
API選定の基準
インディー開発者にとって、既存のライブラリとの互換性は統合コストを劇的に削減します。当APIはOpenAIのspeechエンドポイントと同一のJSON構造を採用しており、base_urlを変更するだけでSDKをそのまま利用可能です。これにより、開発中の環境依存問題を最小限に抑えられます。
OpenAI互換性の重要性
公式SDKのbase_urlをhttps://api.criex.info/v1に変更するだけで、既存のコードベースをそのまま流用できます。追加のパース処理や独自クライアントの作成が不要なため、実装時間を短縮できます。
課金モデルの比較
従量課金制を採用しており、100万文字あたり$10(1,000文字あたり$0.01)です。失敗リクエストは返金対象となるため、無駄なコストが発生しません。月額の基本料金や最小利用額もありません。
レートリミットの考慮
キーあたり1分間60リクエストまで処理可能です。初期状態では1分間10リクエストですが、トップアップ完了後には上限が緩和されます。長文の処理時はバッチ処理を併用し、キュー待機を最適化してください。
音声スタイルの選択
音声合成APIの導入において、適切な音声スタイルの選択はユーザー体験を決定づけます。当APIは8つのプリセットボイスを提供し、SaaS通知やUI音声に最適化された選択肢を揃えています。
各ボイスは明確なトーンと用途に応じて設計されており、開発者はアプリのブランドイメージに合わせた声質を選定できます。技術的な制約を超えた、実用的な音声設計が可能です。
8プリセットの分類
APIは8種類のプリセットボイスを提供します。これらはLibriTTS-Rデータセットに基づき、明確な役割分担で設計されています。開発者は「tts-1」または「tts-1-hd」モデルを選択し、以下の8声から用途に適合するものを選びます。
各ボイスは特定のトーンを維持しており、一貫したユーザー体験を提供します。mp3、wav、opus、flac、pcmの形式で出力可能で、ブラウザやモバイルアプリでの再生に最適化されています。
- aria: 温かくクリアなナレーター
- nova: 明るく活気のあるトーン
- luna: 柔らかく物語的な語り
- sage: 落ち着きのある指示音声
- felix: エネルギー溢れるプロモーション用
- milo: 親しみやすい会話型音声
男女の声の使い分け
音声は男女4声ずつ、計8種類用意されています。女性ボイスのaria、nova、luna、sageは、それぞれナレーター、アップビート、ストーリーテリング、インストラクショナルな用途に適しています。
男性ボイスのfelix、milo、atlas、orionは、プロモーション、会話、ニュース、ドキュメンタリーなどのトーンに対応します。開発者は、アプリのターゲット層や機能に合わせて、男女のバランスを調整できます。
すべてのボイスは23言語に対応しており、言語の違いを超えて一貫した音声品質を保証します。言語を指定しない場合はスクリプトから自動検出されますが、ラテン文字の非英語テキストには言語指定が推奨されます。
音声のトーンと用途
音声のトーンは、SaaS通知やUIフィードバックに特化して設計されています。ariaやsageのような落ち着いた声は、長時間の使用でも疲労を感じさせず、ユーザーの集中力を維持します。
novaやfelixのような活発な声は、アクション完了や通知の強調に適しています。atlasやorionの中立なトーンは、ニュースや情報提供の文脈で信頼性を高めます。
生成される音声ファイルには不可視の透かしが埋め込まれており、合成音声であることを示します。これにより、ユーザーに透明性を提供しつつ、自然な音声体験を実現します。
言語サポートの検証
TTS APIの言語サポートは、グローバル展開の鍵を握ります。当APIは23言語に対応し、多様なターゲット層へのリーチを可能にします。
自動検出の精度を高めるには、languageパラメータの明示的な指定が推奨されます。特にラテン文字圏の非英語圏では、言語の指定が音質向上に直結します。
23言語のリスト
対応言語はアラビア語、中国語、デンマーク語、オランダ語、英語、フィンランド語、フランス語、ドイツ語、ギリシャ語、ヘブライ語、ヒンディー語、イタリア語、日本語、韓国語、マレー語、ノルウェー語、ポーランド語、ポルトガル語、ロシア語、スペイン語、スワヒリ語、スウェーデン語、トルコ語の計23言語です。
どの音声プリセットもこれら全言語で利用可能であり、特定の音声と言語の組み合わせに制限はありません。これにより、開発者はロケーションごとに音声を使い分ける必要がなくなります。
- アラビア語、中国語、デンマーク語、オランダ語、英語
- フィンランド語、フランス語、ドイツ語、ギリシャ語、ヘブライ語
- ヒンディー語、イタリア語、日本語、韓国語、マレー語
- ノルウェー語、ポーランド語、ポルトガル語、ロシア語、スペイン語
- スワヒリ語、スウェーデン語、トルコ語
自動検出の精度
languageフィールドを省略した場合、APIは入力のスクリプトに基づいて言語を推測します。ラテン文字のテキストはデフォルトで英語として処理されるため、日本語や中国語のラテン文字表記(ローマ字など)を誤認識するリスクがあります。
正確な発音を得るためには、languageパラメータにISOコードを明示的に設定してください。これにより、音声エンジンが適切な音韻規則を適用し、より自然な出力が得られます。
非対応言語の確認
対応外の言語としては、ベトナム語、インドネシア語、タイ語、ウクライナ語、ルーマニア語、チェコ語、ベンガル語などがあります。これら言語のテキストを送信すると、英語や他の近接言語として発音される可能性があります。
特定の言語サポートが必要な場合は、事前に言語リストを確認し、languageパラメータの指定漏れや、非対応言語の混入に注意してください。
フォーマットと互換性
音声ファイルの形式はmp3、wav、opus、flac、pcmの5種類から選択可能です。mp3とopusは圧縮形式で帯域節約に寄与し、wavとflacは非圧縮で高品質な出力を得られます。pcmは生データとして処理したい場合に適しています。
ファイルサイズは選択した形式と音声の長さ、速度パラメータによって変動します。mp3やopusは容量が小さく、APIレスポンスの転送コストを抑えられます。wavやflacは原音に近いですが、データサイズが大きくなります。
mp3, wav, opus, flac, pcm
各形式は用途に応じて使い分けます。mp3は一般的なブラウザ再生やWeb配信に最適で、opusはより高い圧縮効率を提供します。wavとflacは録音用や編集用として無損失で保存可能です。pcmは生データとして後処理しやすい形式です。
APIのresponse_formatパラメータで任意の形式を指定できます。特定の形式でのみ音声ファイルを生成したい場合、API呼び出し時に明示的に指定してください。
音声ファイルのサイズ
ファイルサイズは生成される音声の長さと選択した形式に依存します。mp3やopusは圧縮によりサイズが小さくなり、転送時間が短縮されます。wavやflacは非圧縮のため、ファイルサイズが大きくなります。
長文のテキストを音声に変換する場合、音声ファイルのサイズが数MBに達することもあります。APIレスポンスで音声ファイルが返されるため、クライアント側で適切に管理してください。
ブラウザでの再生
mp3、wav、opus形式は主要なブラウザでネイティブに再生可能です。mp3は最も広くサポートされており、ブラウザでの音声再生に最適です。wavは高品質な再生が必要な場合に適しています。
ブラウザでの音声再生には、APIレスポンスで返された音声ファイルのURLを使用します。mp3やopus形式はブラウザの音声再生機能と互換性が高く、スムーズな再生が可能です。
ブラウザでの再生
mp3、wav、opus形式は主要なブラウザでネイティブに再生可能です。mp3は最も広くサポートされており、ブラウザでの音声再生に最適です。wavは高品質な再生が必要な場合に適しています。
ブラウザでの音声再生には、APIレスポンスで返された音声ファイルのURLを使用します。mp3やopus形式はブラウザの音声再生機能と互換性が高く、スムーズな再生が可能です。
実装の簡素化
API統合の初期段階では、cURLコマンドによる簡易テストが最も確実です。POST https://api.criex.info/v1/audio/speechへJSONボディを送信し、音声ファイルを取得します。OpenAI互換の仕様により、SDKのbase_urlを変更するだけで既存のコードベースに統合可能です。
エラーハンドリングでは、HTTPステータスコードを監視します。レートリミット(60req/min)超過時は429を返し、認証エラーは401を返します。失敗したリクエストは課金されないので、再送ロジックを安全に実装できます。
cURLとcurlコマンド
公式ドキュメントには既製のカール例が用意されています。-o output.mp3オプションで直接ファイル保存でき、デバッグ時に有効です。
JSONボディにはmodel、input、voiceフィールドを必須で設定します。speedやresponse_formatはオプションですが、要件に合わせて調整します。
- POST https://api.criex.info/v1/audio/speech
- Authorization: Bearer tts-...
- -o output.mp3
OpenAI SDKの利用
OpenAI公式SDK(Python/Node.js)をそのまま利用できます。base_urlをhttps://api.criex.info/v1に変更するだけで動作します。
既存のOpenAI用コードの修正コストは最小限です。開発者は新しい学習曲線を経験せずにAPIを統合できます。
エラーハンドリング
サーバーエラー時はエラーメッセージと共にステータスコードが返ります。認証キーが無効な場合は401、リクエスト形式が間違っている場合は400を返します。
失敗したリクエストは課金されません。これはテスト環境での反復作業においてコスト増を防ぐ重要な特性です。
コスト管理の実践
KoeFlowの課金は100万文字あたり$10、つまり1,000文字あたり$0.01という明確な文字数ベースのモデルを採用しています。スペースや句読点も文字数に含めるため、実質的なコスト計算は正確に行う必要があります。
この単純な構造により、大規模なバッチ処理でも予測可能な単価でコスト管理が可能です。失敗したリクエストは全額返金されるため、無駄な支出を防げます。
文字数ベースの計算
100万文字で$10という単価は、長文の要約や音声ガイドでも安定したコストを保証します。短くても数秒かかる生成時間に対し、文字数に応じて正確に課金されるため、無駄がありません。
失敗リクエストの無料化
合成に失敗した場合、その文字数は課金されません。エラー時の再試行コストがゼロになるため、ネットワークの不安定な環境でも安心してAPIを呼び出せます。
USDT.top-upの効率
TRC-20のUSDTのみで最小$5からチャージ可能です。銀行口座やクレジットカード登録の手間がなく、数分で残高が反映されます。サブスクリプションも不要で、使い分けた支払いが実現します。
スケーラビリティの考慮
インディー開発者がTTS APIを大規模に運用する際、バッチ処理とキュー管理はコスト効率と安定性を左右する重要な要素です。本APIは1リクエストあたり最大4096文字まで処理可能ですが、長文の処理にはテキストを分割し、生成された音声ファイルを結合する実装が推奨されます。
レートリミット(60リクエスト/分)を超えるとキューに待機するため、バッチ送信時には間隔を空ける設計が必要です。失敗リクエストは課金対象外となるため、再送ロジックを組み込んでもリスクなくスケールできます。
バッチ処理の実装
1回のリクエストで4096文字を超える文章を処理するには、クライアント側でテキストを分割し、複数回のAPIコールを実行します。各音声ファイルは個別に生成されるため、音声結合ツールやライブラリを使用して最終的な音声ファイルを作成する必要があります。
短詩的な音声生成には数秒、長文では実時間速度(1秒あたり約25文字)で処理されるため、バッチサイズを調整してユーザーの待機時間を最適化できます。
- 1リクエスト最大4096文字
- 分割テキストの音声結合が必要
- 短詩は数秒、長文は実時間速度
キュー管理の仕組み
リクエストは順次処理されるため、同時多発のリクエストがキューに溜まる可能性があります。レートリミット(60リクエスト/分)に達すると、新しいリクエストはキューに待機し、処理が完了次第実行されます。
キューの状況はAPIレスポンスのステータスコードや遅延時間で把握できます。キューが長引く場合は、バッチ送信のタイミングをずらすか、クライアント側で再送ロジックを実装します。
- リクエストは順次処理
- レートリミット超でキュー待機
- レスポンス遅延でキュー状況把握
レートリミットの回避策
1キーあたり60リクエスト/分の制限を回避するには、バッチ送信時に適度な待機時間(例:1秒間隔)を設けます。これにより、キューの蓄積を防ぎ、安定した処理速度を維持できます。
失敗リクエストは課金対象外となるため、再送ロジックを組み込んでもコスト増を防げます。複数のキーを併用することも可能ですが、本APIでは1アカウントにつき1キーのみが有効です。
- 1キー60リクエスト/分
- 待機時間設定でキュー蓄積防止
- 失敗リクエストは無料のため再送可能

データのプライバシー
KoeFlowのAPIは、入力テキストを音声生成の目的のみに使用し、モデルのトレーニングには利用しません。生成された音声ファイルはレスポンスで返された後、ストレージに保持されません。
請求処理のために、リクエストの時刻、文字数、ステータスなどのメタデータのみが記録されます。これにより、利用履歴の透明性が確保されつつ、コンテンツそのものは永続的に保存されません。
入力テキストの保存
入力テキストは音声生成の目的のみに使用され、後続の分析や再利用の対象とはなりません。
トレーニングデータの不使用
生成プロセスで使用されたテキストデータは、音声モデルの学習や改善のためのトレーニングデータとして収集・使用されることはありません。これは、ユーザーのコンテンツが独自の資産として機能することを保証します。
生成音声の保管
音声ファイルはレスポンスとして返され、サーバー側には永続的に保管されません。ただし、課金の正確性を保つため、リクエストのメタデータ(時刻、文字数、ステータス)は請求期間に応じて保持されます。
サポートとドキュメント
インディー開発者にとって、APIのエラー発生時や課金疑問への迅速な対応は実装の信頼性に直結します。当サービスでは、電話やライブチャットを導入せず、すべての問い合わせをメールサポートに一本化しています。これにより、技術的な詳細を正確に記録・共有でき、開発者同士の知識共有を促進します。
メールサポートの反応
サポートはメールのみです。音声通話や即時チャットはありませんが、技術的な課題に対しては丁寧で具体的な回答が返されます。深夜でもリクエストは記録され、営業時間内に処理されます。
- メールベースのサポートのみ
- 電話やライブチャットなし
- 技術的な詳細を重視した回答
ドキュメントの充実度
ドキュメントは実装に直結する事実のみを記載します。cURLコマンドやOpenAI互換SDKの使用例、パラメータの制約(最大4096文字など)が明確です。余計な装飾なく、コピー&ペーストで動作するコード例を提供します。
- 実装直結の事実ベース
- cURLとSDKの使用例
- パラメータ制約の明確な記載
FAQの有用性
FAQは、レートリミットやUSDTによるトップアップ方法など、頻出する技術的・課金疑問に焦点を当てています。重複する情報を避け、開発者が即座に解決策を見つけられるよう設計されています。
既存のセクションでカバーされていない、具体的なエラーコードや境界値の問題も記載しています。これにより、サポートリクエストの数を削減し、開発の効率化を図ります。
競合他社との比較
KoeFlowのAPIはOpenAIと互換性があり、SDKの変更のみで統合可能です。しかし、独自のエコシステムやSSML、カスタム音声クローニングは提供していません。価格体系も文字数ベースで透明です。
OpenAIとの違い
エンドポイントはOpenAI Speech APIと同一形状ですが、独自の実装です。SDKのbase_urlを変更するだけで利用可能です。音声のクローニング機能やSSMLタグのサポートは提供していません。
ElevenLabsとの比較
ElevenLabsはカスタムクローニングを提供していますが、KoeFlowは8つのプリセット声に特化しています。音声の多様性よりも、シンプルさと安定したコスト管理を重視する開発者向けです。
独自の利点
USDT(TRC-20)による即時のチャージと、失敗リクエストの無料返金が特徴です。データはトレーニングに使用されず、生成音声は保存されません。インディー開発者のコスト計算を簡素化します。
レートリミットは60リクエスト/分ですが、キュー処理により安定した動作を保証します。
- USDTでの最小$5からチャージ可能
- 失敗時の課金返金保証
- トレーニングデータ使用なしのプライバシー
音声の品質と制限
生成された音声ファイルには、聴覚的に判別できない合成音声の透かしが埋め込まれています。これにより、AI生成音声であることを識別可能にします。
音声の自然さは、licensed recordingsに基づき、8つのプリセットで明確に使い分けられます。
合成音声の透かし
すべての生成ファイルには、人間の耳には聞こえないレベルの透かしが自動で埋め込まれます。これは音声の合成性を示すための技術的措置です。
音声の自然さ
LibriTTS-RおよびLibriVoxのデータに基づき、8つのプリセットが提供されます。各プリセットは明確なトーンを持ち、SaaS通知やUI音として適した自然な流れを持っています。
音声の多様性
男女4声ずつの8プリセットと23言語の組み合わせにより、多様なシチュエーションに対応します。ただし、感情タグやカスタムクローンは提供されません。
将来の展望と制限
当APIは現在、ストリーミングやSSML、音声クローニングなどの機能を備えていません。将来的な追加計画は未定ですが、現在の仕様は安定した提供を優先しています。
機能の追加予定
現在、モバイルSDKやブラウザ拡張機能は提供していません。SSMLやカスタム発音辞書、感情タグも非対応です。将来的な追加計画は明示されていません。
現在の制限事項
最大4096文字のリクエスト制限があり、同時実行はレートリミット(1分間60リクエスト)に依存します。音声の品質は合成音声特有の透かしを内蔵しており、完全な人間のような多様性には限界があります。
サポートはメールのみで、電話やライブチャットはありません。SLAや稼働率保証、各種認証(SOC 2など)も付与されていません。
- 最大入力文字数: 4096文字
- レートリミット: 1分間60リクエスト
- サポート: メールのみ
アップデートの通知
新機能や仕様変更の通知は、主にウェブサイト上のドキュメント更新を通じて行われます。メールマガジンやプッシュ通知などの公式な通知チャネルは現在提供されていません。
変更がある場合は、公式ドキュメントサイトでご確認ください。
8つの音声を確認
以下の各サンプルは、同じ文章をこのAPIで生成したものです。 テキストは音声生成の処理中にのみ使用され、永続的なデータベースに格納されて学習データとして再利用されることはありません。
23言語
どの音声でも、これらの言語のいずれかを話します。
出典および参考資料
- Wikipedia
- curl documentation
- MDN: Web Speech API
- openai-node on GitHub
- LibriTTS-R corpus (OpenSLR 141)
- TRON developer hub: TRC-20
- Node.js documentation
- OpenAI API reference: create speech
- W3C WAI: making audio and video accessible
- Creative Commons Attribution 4.0
- openai-python on GitHub
- IETF RFC 7845: Ogg Opus
