KoeLink音声生成APIの活用方法

作成者 TTS Play編集部 · 更新日 2026-11-18

このガイドでは、KoeLinkの音声合成APIをプロジェクトに効率的に統合するための手順を解説します。APIキーの取得からOpenAI SDKの設定、音声の最適化やエラー処理まで、開発者が直面する一般的な課題に対応する具体的なワークフローを提供します。

レスポンス時間やレートリミット、セキュリティ対策などの技術的なポイントも網羅しています。ブラウザデモでの確認から本番環境へのデプロイまで、音声生成をスムーズに進めるための実用的な情報をまとめました。

KoeLink音声生成APIの活用方法

よくある質問

APIの選択方法は?

エンドポイントは POST https://api.playe67.com/v1/audio/speech です。リクエストボディには model(tts-1 または tts-1-hd)、input(最大4096文字)、voice、response_format、speed を指定します。認証には Authorization: Bearer ヘッダーを使用し、有効なAPIキーを送信してください。

SDKの設定方法は?

公式OpenAI SDKを使用し、base_url を https://api.playe67.com/v1 に変更します。APIキーはアカウントページで確認できます。他のエンドポイントとして /v1/voices や /v1/models も利用可能です。独自SDKやモバイルSDKは提供していません。

音声の最適化方法は?

8種類のプリセットボイスから選択します。速度は0.25〜4.0で調整可能です。フォーマットはmp3、wav、opus、flac、pcmから選べます。長文は4096文字ごとに分割し、生成された音声ファイルを結合して使用してください。

エラーの処理方法は?

合成に失敗した場合は、課金が全額返金されます。APIキーのレートリミットは1分あたり60リクエストです。リクエストはキューで処理されるため、負荷が高い場合は待機時間がかかる場合があります。

パフォーマンスの改善方法は?

リクエストは順次処理されます。長文の生成は約25文字/秒の速度です。短くても数秒かかります。同時実行数の制限はありませんが、キュー待ちが発生する可能性があります。効率的な処理のため、適切な分割戦略を検討してください。

セキュリティの確保方法は?

APIキーは Authorization: Bearer ヘッダーで送信します。1アカウントにつき有効なキーは1つで、新しいキー発行時に古いキーは即時無効になります。入力テキストは音声生成にのみ使用され、学習には利用されません。

スケーリングの方法は?

月額プランやサーバー枠の制限はありません。APIキーごとのレートリミットは1分60リクエストです。必要に応じてキーを追加発行するか、クライアント側でリクエストを分散させることで対応可能です。エンタープライズ契約は提供していません。

テストの方法は?

Googleサインインで登録すると、7日間有効な$0.50の無料クレジットが得られます。これにより約5万文字をテストできます。APIキーページでcurl例を確認し、実際のリクエストで動作検証を行ってください。

デプロイの方法は?

生成された音声ファイルはレスポンスとして返され、サーバーには保存されません。必要な場合は、クライアント側でファイルを取得して保存するか、ストリーミングせずにダウンロードしてください。ストリーミングやWebSocketはサポートしていません。

保守の方法は?

Uptime保証やSLAはありません。APIキーが期限切れまたは無効化された場合は、アカウントページから再発行してください。サポートはメールのみで、電話やライブチャットはありません。定期的なキーの管理が必要です。

トラブルシューティングの方法は?

エラー時は課金が返金されます。レートリミット超過時は待機してください。言語が正しく認識されない場合は、language パラメータで明示的に指定してください。サポートはメールのみです。具体的なエラーメッセージを確認し、リクエストパラメータを見直してください。

リソースの場所は?

APIベースURLは https://api.playe67.com/v1 です。ドキュメントは /docs/ 、価格情報は /pricing/ 、アカウント作成は /get-api-key/ から行えます。サポートはメールのみで、他の連絡先は提供していません。

APIの選択基準

の音声波形イラスト: APIの選択基準

音声合成APIを選ぶ際は、まずエンドポイントの互換性を確認しましょう。当社のAPIはOpenAIのSpeechエンドポイントと同一の形状を採用しており、base_urlを変更するだけで既存のOpenAI SDKをそのまま利用できます。これにより、開発環境の移行コストを最小限に抑えることができます。

互換性のあるエンドポイント

POST https://api.playe67.com/v1/audio/speech へJSONボディを送信するだけのシンプルな構造です。音声リストやモデル情報は GET /v1/voices や GET /v1/models で取得可能です。

  • OpenAI SDKのbase_url変更のみで動作
  • 標準的なJSONリクエスト形状を採用

ドキュメントの充実度

必要なパラメータ(model, input, voiceなど)や制限事項はドキュメントページで明確に定義されています。8種類の音声プリセットや23言語の対応状況、文字数制限も記載されているので、迷うことなく統合を進められます。

コストの透明性

コストは使用した文字数に応じて課金されます。100万文字あたり10ドル(1,000文字あたり0.01ドル)という明確な単価です。失敗したリクエストは無料となるため、無駄なコストも発生しません。

統合の手順

の音声波形イラスト: 統合の手順

APIキーの取得

まず、/get-api-key/ページからGoogleまたはメールアドレスでサインアップし、APIキーを取得します。アカウント作成時には無料トライアルとして$0.50(約5万文字分)が与えられますが、これは7日間限定です。パスワード認証で作成したアカウントにはこのトライアルクレジットは含まれませんので、注意してください。

SDKの設定

OpenAI SDKをベースにbase_urlを「https://api.playe67.com/v1」に設定して使用します。これにより、公式SDKと同じリクエスト形状で音声合成が可能です。認証にはAuthorization: Bearerヘッダーに取得したキーを設定します。

最初のテスト

短いテキストを送信して、音声ファイルが返ってくるか確認しましょう。レートリミットは初期状態で1分あたり10リクエストです。最初のトップアップ後は60リクエストに増えますので、テスト段階ではリミットに注意して調整してください。

音声の最適化

の音声波形イラスト: 音声の最適化

音声生成の品質と用途に合わせて、8種類のプリセットから最適な音声を選ぶことが重要です。話者のトーンはナレーターからニュース配信まで多様にそろっており、プロジェクトの雰囲気に合わせやすくなっています。

音声の選択

8種類のプリセットから選べます。Ariaは温かみのあるナレーター、Novaは明るく元気なトーンです。また、Sageは教育的な内容に、Atlasは中立的なニュース配信に適しています。どの音声も23言語に対応しており、言語指定を省略するとスクリプトから自動判定されますが、非英語のラテン文字テキストには明示的な指定が推奨されます。

  • Aria: 温かみのあるナレーター
  • Nova: 明るく元気なトーン
  • Luna: 柔らかいストーリーテリング
  • Sage: 落ち着いた教育向け
  • Felix: エネルギー溢れるプロモーション
  • Milo: 親しみやすい会話調
  • Atlas: ニュース向けの中立なトーン
  • Orion: 深くドキュメンタリー調

速度の調整

再生速度は0.25から4.0の範囲で調整可能です。通常、長文テキストでは1秒あたり約25文字の生成速度になります。短めのフレーズは数秒かかりますが、リクエストはキューで順番に処理されるため、負荷が高い場合は待ち時間が発生する可能性があります。

フォーマットの変換

出力フォーマットはmp3、wav、opus、flac、pcmから選べます。APIはJSONボディでリクエストを受け取り、音声ファイルを返します。4096文字を超える長文は分割して生成し、音声を結合する必要があります。生成された音声ファイルには合成音声を示す不可視の透かしが含まれます。

エラーの処理

の音声波形イラスト: エラーの処理

API連携時にネットワーク不安定で音声生成に失敗する場合があります。失敗したリクエストは返金対象となり、チャージは全額戻ります。サーバー側の一時障害や接続切断に備え、単純な再送ロジックを実装しておきましょう。

レートリミットはキーあたり毎分60リクエストです。最初のトップアップ前は毎分10リクエストに制限されます。キューが長引く場合、待機時間を考慮したバックオフ処理が必要です。

ネットワークエラー

通信途断時は400系エラーが返ります。失敗したリクエストは課金対象外なので、データを無駄に消費しません。安定した接続環境でテストを実行してください。

  • 失敗時の返金保証が適用されます
  • 再接続ロジックを簡易に実装可能

レートリミット

1キーあたり毎分60リクエストが上限です。未課金時は毎分10リクエストに制限されます。同時並列処理時はキューが混雑し、生成に数秒待機する可能性があります。

大量テキストを処理する際は、4096文字ごとに分割して複数リクエストを送信してください。これにより、レートリミットの影響を分散できます。

  • 通常: 60 req/min
  • 課金前: 10 req/min

無効な入力

4096文字を超えるテキストはエラーになります。アプリ側で文字数を分割し、生成された音声ファイルを結合する処理を実装してください。

音声コードやモデル名が不正な場合、即時エラーが返ります。事前にGET /v1/voicesで利用可能な音声リストを取得しておきましょう。

  • 文字数制限は4096文字
  • 不正パラメータで即時エラー

パフォーマンス

の音声波形イラスト: パフォーマンス

音声合成APIのパフォーマンスを理解することは、スムーズなユーザー体験のために不可欠です。生成速度は入力テキストの長さや同時接続数によって変化するため、適切な設定が求められます。

特に大量のテキストを処理する際は、キューの状況を確認し、適切な間隔でリクエストを送信することが重要です。これにより、過剰な負荷を避け、安定した応答を得られます。

レスポンス時間

短めのフレーズは数秒で生成されますが、長文は実時間再生速度に近い速度で処理されます。具体的には、約25文字が1秒間に生成される計算になります。ただし、リクエストは順番に処理されるため、混雑時にはキュー待ちが発生する可能性があります。

キューの管理

リクエストは1つずつ処理されるため、短时间内に多数の送信を行うと遅延が生じます。特にバッチ処理を行う際は、適度な待機時間を入れながら送信することで、キューの積もりを防ぎましょう。

並列処理

クライアント側で複数のリクエストを並列送信することで処理時間を短縮できます。ただし、1分あたり60リクエストというレートリミットを超えないよう注意してください。並列数は同時接続数に依存し、サーバーの負荷状況に応じて調整が必要です。

セキュリティ

の音声波形イラスト: セキュリティ

APIキーはプロジェクトの鍵です。有効なキーは1つだけ管理し、不要なアクセスを防ぎます。

HTTPS経由で通信することで、転送中のデータが安全に保たれます。

キーの保護

認証には Authorization: Bearer ヘッダーを使用します。キーは環境変数に格納し、ソースコードに直接書き込まないでください。キーが漏洩した場合は、ダッシュボードから新しいキーを発行できます。古いキーは即座に無効化されます。

  • APIキーは秘密に保つ
  • 新しいキーは旧キーを即時無効化

HTTPSの使用

エンドポイントは https://api.playe67.com/v1 です。テキストと音声データは暗号化された接続を通じて送受信されます。これにより、ネットワーク上の傍受を防ぎます。

データの使用制限

入力テキストは音声生成のみに使用され、モデルの学習には利用されません。生成された音声はレスポンスで返され、サーバーには保存されません。課金用のメタデータのみが記録されます。

  • 学習データとして使用しない
  • 生成音声は保存しない

スケーリング

の音声波形イラスト: スケーリング

KoeLinkのAPIは、キーあたり1分あたり60リクエストという明確な制限があります。大量のテキスト処理では、4096文字ごとに分割して結合する手法が有効です。これにより、単一リクエストの負荷を分散させ、安定した音声生成を実現できます。

短期間の急増に対応するには、バッチ処理を工夫し、キューの混雑を避けることが重要です。

トラフィックの増加

1分あたり60リクエストの制限を考慮し、短時間で大量のテキストを処理する際は、4096文字ごとに分割して生成し、最後に結合する方法が効果的です。これにより、単一リクエストの負荷を軽減し、連続した音声として出力できます。

リソースの最適化

生成速度は実時間付近(1秒あたり約25文字)ですが、短文処理には数秒かかります。同時実行数を増やしすぎず、キューの待ち時間を最小限に抑えるよう、バッチサイズを調整してください。

負荷分散

APIキーは1アカウントにつき1つですが、ピーク時の負荷を避けるため、時間帯をずらしてリクエストを送信する運用も有効です。また、失敗リクエストは無料なので、再送ロジックを安全に実装できます。

スケーリング

テスト

の音声波形イラスト: テスト

API連携の信頼性を確保するには、テスト段階での検証が不可欠です。音声合成APIはテキストを音声に変換するシンプルな構造ですが、ネットワークの不安定性やレート制限の影響を事前に把握しておくことが重要です。

テストを通じて、予期しないエラーやパフォーマンスのボトルネックを特定し、本番環境でのトラブルを最小限に抑えましょう。

単体テスト

各パラメータが正しく動作するか確認します。inputの文字数制限(4096文字)や、サポートされる音声、言語、フォーマットが指定通り反映されているかチェックしてください。

失敗したリクエストは課金されないため、テスト用の短いテキストでAPIコールを実行し、ステータスコードと応答フォーマットが正しいか検証します。

  • 4096文字以内のテキストで正常系テストを行う
  • 不正なパラメータでエラーレスポンスを確認する

統合テスト

実際のアプリケーション環境でAPIキーとSDKの連携を確認します。base_urlの変更や認証ヘッダーが正しく設定されているか検証しましょう。

音声ファイルのダウンロードや再生が、期待するフォーマット(mp3, wavなど)で正常に行えるか確認します。

  • SDKの設定値がAPI仕様に合致しているか確認
  • 複数言語での音声生成結果を検証

パフォーマンステスト

レートリミット(1分60リクエスト)を超えた場合の挙動を確認します。キューの管理や、負荷時の応答時間の変動を把握しておきましょう。

長時間のテキストを分割して合成する際、音声ファイルの結合がスムーズに行えるかテストします。

  • 60リクエスト/分の制限下での同時アクセステスト
  • 分割合成の結合品質を確認する

デプロイ

の音声波形イラスト: デプロイ

デプロイでは、KoeLink APIを本番環境に安全に統合することが重要です。APIキーの保護とHTTPS通信の確保により、音声生成パイプラインの信頼性を高めます。

モニタリングとログ管理は、コストの透明性とパフォーマンス維持に不可欠です。失敗したリクエストは無料ですが、正常なリクエストのメタデータは請求のために保持されます。

環境の設定

本番環境では、APIキーを環境変数として管理し、コード内に直接埋め込まないことを推奨します。tts-1またはtts-1-hdエンドポイントへの接続設定は、OpenAI SDKのbase_urlを変更するだけで可能です。

  • APIキーは環境変数で管理
  • HTTPS通信を必須にする
  • エンドポイントはhttps://api.playe67.com/v1

モニタリング

リクエストごとのステータスと文字数を確認し、レートリミット(1分60リクエスト)を監視します。失敗したリクエストは返金されるため、コスト計算時は正常完了分のみを基準にしてください。

  • 1分あたり60リクエストの制限を確認
  • 失敗時の返金状態を確認
  • 文字数とステータスを記録

ログの管理

リクエストメタデータ(時刻、文字数、ステータス)は請求のために保持されます。音声データ自体は保存されないため、ログは主に課金の検証とデバッグに利用できます。

  • メタデータは請求のために保存
  • 音声ファイルは保存されない
  • ログは課金検証に利用

保守

の音声波形イラスト: 保守

APIの更新やキーの管理は、サービス継続の基盤です。KoeLinkでは、新しいAPIキーを発行すると古いキーは即時無効化されるため、切り替えを慎重に行いましょう。

コスト監視は課金の透明性を保ちます。TRC-20でのチャージや失敗時の返金ルールを理解し、予算を適切に管理してください。

APIの更新

KoeLinkでは、アカウントから新しいAPIキーをいつでも発行できます。新しいキーが発行されると、既存のキーは直ちに無効化されるため、接続中のサービスが中断されないよう注意してください。

キーのローテーション

セキュリティのため、定期的なキーのローテーションが推奨されます。新しいキーを取得後、コード内の設定を更新し、古いキーが完全に機能しなくなっていることを確認してください。

  • 新しいキー発行は即時有効
  • 旧キーは直ちに無効化

コストの監視

100万文字あたり$10の従量課金制です。失敗したリクエストは無料になるため、過剰な請求を気にする必要はありません。ダッシュボードで残高と使用量を確認しましょう。

  • 失敗時は全額返金
  • 残高は有効期限なし

トラブルシューティング

の音声波形イラスト: トラブルシューティング

API連携時に遭遇する可能性のある一般的な問題と、その解決策を確認しましょう。

デバッグの手順について解説します。

一般的な問題

文字数制限(4096文字)を超えるとエラーになります。また、レートリミット(60リクエスト/分)に達すると待機が必要になります。音声ファイルの生成には数秒〜実時間レベルの時間を要する場合があります。

ネットワーク環境が悪くリクエストがタイムアウトする場合、再接続ロジックを実装してください。無効な音声名やフォーマットもエラーの原因となります。

  • 文字数オーバー: 4096文字で分割する
  • レートリミット: 1分間60リクエストまで
  • 生成遅延: キュー待ちの可能性あり

デバッグツール

レスポンスヘッダーやステータスコードを確認してください。失敗したリクエストは課金されません。

APIキーの有効性と残高はダッシュボードで即時確認できます。

サポートへの連絡

電話やライブチャットはありません。サポートはメールのみです。

エラーログやリクエストIDを添えてお問い合わせください。返信までお待ちください。

  • サポート: メールのみ

リソース

の音声波形イラスト: リソース

API開発と音声生成のワークフローを加速させるための公式ドキュメントとサンプルコードをまとめました。具体的な実装例や設定方法を確認し、プロジェクトにすばやく組み込んでください。

サポートはメールのみで提供しています。詳細な仕様や最新の変更は公式ドキュメントを参照し、不明点はお気軽にお問い合わせください。

ドキュメントのリンク

エンドポイントの仕様、パラメータの詳細、エラーコードについては /docs/ のリファレンスをご確認ください。OpenAI互換の仕様に基づいているため、既存のSDKをそのまま利用可能です。

  • /docs/ APIリファレンス
  • OpenAI互換エンドポイント仕様

サンプルコード

PythonやNode.jsなどの主要言語で、cURLを含む具体的なリクエスト例を提供しています。base_urlを https://api.playe67.com/v1 に変更するだけで、すぐにテストを実行できます。

音声生成のパターンや速度調整の設定例も記載しており、実装の参考としてそのままコピー&ペーストしてご利用ください。

コミュニティ

公式のコミュニティフォーラムやSNSチャネルを通じて、他の開発者と情報交換できます。

また、不具合や機能のご要望については /contact/ よりメールにて受け付けています。

  • メールサポート: /contact/

8つの音声を確認

以下の各サンプルは、同じ文章をこのAPIで生成したものです。 あなたのアイデアをコードなしで自由に形に変えていきましょう。

音声のアバター aria
aria女性
音声のアバター nova
nova女性
音声のアバター luna
luna女性
音声のアバター sage
sage女性
音声のアバター felix
felix男性
音声のアバター milo
milo男性
音声のアバター atlas
atlas男性
音声のアバター orion
orion男性

23言語

どの音声でも、これらの言語のいずれかを話します。

出典および参考資料

  1. Wikipedia
  2. Tether (USDT)
  3. ISO 639 language codes
  4. curl documentation
  5. OpenAI API reference: create speech
  6. TRON developer hub: TRC-20
  7. Node.js documentation
  8. W3C WAI: making audio and video accessible
  9. openai-node on GitHub
  10. Creative Commons Attribution 4.0
  11. LibriTTS-R corpus (OpenSLR 141)
  12. Python documentation

このサイトに関するその他の情報