よくある質問
読み上げ API はどう使いますか?
POST https://api.playt19.com/v1/audio/speech に JSON 本文を送信し、音声ファイルを受け取ります。最大 4096 文字のテキストを指定し、モデルや音声、言語を設定します。長文の場合は分割して生成し、音声ファイルを結合してください。
APIキーはどこで取得しますか?
サイト内の /get-api-key/ ページで Google またはメール登録を行うと取得できます。アカウントには 1 つのアクティブなキーが割り当てられ、必要に応じて新しいキーを発行できます。旧キーは即時無効になります。
curlコマンドは使えますか?
はい、標準的な curl コマンドで API を操作できます。/get-api-key/ ページには、認証情報とパラメータを指定した準備済みの curl 例が表示されています。これを使用して、音声生成リクエストを簡単にテストできます。
OpenAI SDKは使えますか?
リクエストの形状が OpenAI の speech エンドポイントと同一のため、公式 OpenAI SDK を使用できます。base_url を https://api.playt19.com/v1 に変更し、サイト発行のキーを使用してください。独自 SDK は提供していません。
レートリミットは?
キーあたり 1 分間あたり 60 リクエストです。初回のチャージ前は 1 分間あたり 10 リクエストの制限があります。
エラー時の処理は?
音声合成に失敗した場合、料金は全額返金されます。失敗したリクエストに対しては課金が行われないので、クライアント側で再試行ロジックを実装しても問題ありません。成功時のみ課金されます。
音声ファイルの形式は?
mp3、wav、opus、flac、pcm の 5 形式から選択できます。IoT デバイスや Web アプリケーションの要件に応じて、適切な形式を指定して音声ファイルを生成してください。
認証方法は?
HTTP ヘッダー Authorization: Bearer <API_KEY> を使用して認証します。取得した API キーを Bearer トークンとしてリクエストに付与してください。キーが有効であれば、音声生成リクエストが処理されます。
ストリーミングはサポートしていますか?
ストリーミング、WebSocket、リアルタイムの部分的な音声生成はサポートしていません。テキストを送信すると、処理完了後に音声ファイルが返されます。リアルタイム性が求められる用途には適していません。
SSMLはサポートしていますか?
SSML(Speech Synthesis Markup Language)はサポートしていません。音声の制御は速度パラメータのみで行えます。詳細な発音制御や区切りが必要な場合は、テキスト側で調整してください。
カスタム音声はサポートしていますか?
顧客向けの音声クローニングや独自の音声アップロードはサポートしていません。8 種類のプリセット音声から選択してください。独自の音声デザインやカスタム音声は提供していません。
音声のクローニングはサポートしていますか?
カスタム音声クローニングはサポートしていません。既存の8種類のプリセット音声(aria, nova, luna, sage, felix, milo, atlas, orion)から選択してください。独自の声を登録する機能や、音声デザイン機能はありません。
音声のデザインはサポートしていますか?
音声のデザイン機能はサポートしていません。音声はLibriTTS-RおよびLibriVoxの既存ライセンス録音に基づいて生成され、カスタムボイスクローニングや感情タグ、独自音声のアップロードは提供していません。8つのプリセットから選択し、速度や言語のみを調整して音声ファイルを生成します。
音声の感情タグはサポートしていますか?
Q: 音声の感情タグはサポートしていますか? A: 感情タグはサポートしていません。音声のトーンは音声ごとに固定されています。感情を制御するためのパラメータは提供されていないため、テキストの内容で感情を表現してください。
編集部について
SmartKoeは、IoTデバイスやWebアプリへの音声組み込みを専門とする読み上げAPIプラットフォームです。API経由で音声ファイルを生成し、スマートホームや通知システムへの実装を支援します。
SmartKoe
当サービスは、複雑な音声処理を必要とせず、シンプルなAPIエンドポイントで音声合成が可能です。60リクエスト/分のレートリミットと、100万文字あたり$10(1,000文字あたり$0.01)という明確な料金体系を提供します。
- API経由での音声ファイル生成
- スマートホーム・IoT向け最適化
ノーコード開発者向け
コードの記述を最小限に抑えた設計です。既存のOpenAI SDKのbase_urlを変更するだけで利用可能であり、curlコマンドのサンプルも提供します。認証キーの発行や残高管理もWeb画面から完結します。
- OpenAI SDKとの互換性
- 複雑なインフラ不要
音声アシスタント
8種類のボイスプリセットから、用途に合った音声を選択できます。英語、日本語、中国語など23言語に対応し、ISOコードを指定することで言語を明示できます。音声は合成音声であることが透かしで識別可能です。
- 8種類の音声プリセット
- 23言語に対応
音声のライセンス
SmartKoeの音声は、LibriVoxの朗読データに基づいています。これにより、安定した品質で音声合成を実現しています。
ライセンスとソースを明確にし、開発者が安心してAPIを利用できるようにしています。
LibriTTS-R
音声の基盤データセットはLibriTTS-Rです。このデータセットは、多数の朗読音声を含み、多様な音声特徴を学習しています。
CC BY 4.0
音声の基盤データセット(LibriTTS-R)はクリエイティブ・コモンズ表示4.0 (CC BY 4.0) のライセンスです。
LibriVox
LibriVoxはパブリックドメインのオーディオブック読書を提供しています。SmartKoeはこれらの録音に基づいて音声エンジンを構築しています。
データポリシー
SmartKoeの読み上げAPIでは、入力テキストは音声合成のためにのみ使用され、モデルの学習データには再利用されません。生成された音声ファイルはレスポンス経由で返却され、サーバー上には音声ファイル自体は保存されません。
学習用データ使用なし
入力されたテキストは、音声ファイルの生成という目的のためにのみ処理されます。生成プロセスが完了した後、そのテキストはモデルのトレーニングデータとして再利用されることはありません。これにより、ユーザーのコンテンツが継続的に学習データとして収集されるリスクを排除します。
音声ファイルの保存なし
APIレスポンスを通じて音声ファイルが返却された後、サーバー側には音声ファイル自体は保存されません。これにより、生成された音声コンテンツの長期保管に伴うストレージコストやプライバシー上の懸念を最小限に抑えます。
課金用メタデータの保持
課金の正確性を確保するため、リクエストの時刻、文字数、ステータスなどのメタデータは保持されます。これらは請求の検証と記録のために使用され、音声コンテンツそのものとは別に管理されます。
制限事項
SmartKoeのAPIは、シンプルで高速な音声合成に特化しています。複雑な制御が不要なIoTやノーコード環境での利用を想定し、必須機能に絞って設計しています。
ストリーミング非対応
音声ファイルは生成完了後にダウンロード形式で返却されます。リアルタイムのストリーミングやWebSocket通信には非対応です。
SSML非対応
音声の強調や間隔調整にはSSMLタグを使用できません。速度(speed)パラメータのみで調整可能です。
カスタム音声非対応
既存の8音声(aria, nova, luna, sage, felix, milo, atlas, orion)から選択します。独自の声を登録するクローニング機能は提供していません。

サポート方法
SmartKoeのサポートはメールのみです。音声アシスタントやIoTシステムの構築中にAPIの仕様や課金について質問がある場合は、専用アドレス宛てにご連絡ください。
電話窓口やライブチャットは設置していません。エンジニアリングチームがメールで返信します。
FAQや公式ドキュメントもご参照ください。
メールのみ
音声合成APIの利用に関する問い合わせは、すべてメールで行ってください。アカウントのキー再発行や課金エラーなど、具体的なエラーメッセージやリクエストIDを記載すると、処理が早くなります。
- サポートアドレス: [email protected]
- 返信は営業時間内に順次対応
電話なし
音声通話やダイヤルインのサポート窓口は持っていません。即時の音声対応が必要な場合でも、メールで詳細を記載していただければ、必要な情報を確実に伝達できます。
チャットなし
ウェブサイトの右下に常駐チャットウィジェットは表示していません。リアルタイムのチャットサポートは提供していませんが、メールでのやり取りは確実に記録され、後から参照可能です。
お問い合わせ
SmartKoeの「お問い合わせ」セクションでは、公式サポートの連絡方法と関連リソースへのアクセスパスを明確に示しています。ノーコード開発者が音声アシスタントやIoTシステムを構築する際に、技術的な疑問や課金に関する確認が必要な場合に利用します。
サポートはメールのみで提供され、電話やライブチャットは行いません。迅速な対応を目指しますが、応答時間は状況により異なります。詳細な技術仕様やAPIの使用例は、別途用意されたドキュメントを参照してください。
メール送信
技術的な問題やアカウントに関する問い合わせは、公式メールアドレス宛てに送信してください。件名には「[SmartKoe] お問い合わせ」を明記し、利用しているAPIバージョンとエラー内容(該当する場合)を記載してください。
メールアドレスは「[email protected]」です。営業日のうちに対応メールをお送りしますが、祝日や連休中は遅延する可能性があります。
- 件名:[SmartKoe] お問い合わせ
- 必須情報:APIバージョン、エラーログ(任意)
- メールアドレス:[email protected]
FAQの閲覧
よくある質問(FAQ)ページでは、APIキーの発行方法、課金の仕組み、音声の制限事項など、一般的な疑問への回答をまとめています。
先にFAQを閲覧することで、即座に解決できるケースが多くあります。特に「レートリミット」や「文字数カウント」に関する確認はここで済ませてください。
APIドキュメントへ
エンドポイントの詳細、リクエストパラメータ、レスポンス形式については「/docs/」のAPIドキュメントを参照してください。
curlコマンドの例や、OpenAI互換のSDK利用方法も記載されています。音声アシスタントやIoTデバイスへの実装例も掲載しています。
8つの音声を確認
以下の各サンプルは、同じ文章をこのAPIで生成したものです。
23言語
どの音声でも、これらの言語のいずれかを話します。
