よくある質問
利用前に迷いやすい点をまとめました。個別の条件はリンク先の各文書を確認してください。
本当に無料ですか?
はい。個人・法人、商用・非商用を問わず無料で使えます。ただし VOICEVOX 本体と各音声ライブラリの 規約(特にクレジット表記)には従う必要があります。
商用利用できますか?
可能です。ただし話者ごとに条件が異なり、法人・企業が関わる利用や商用利用に事前の 確認・問い合わせが必要な話者、非商用を前提とする話者もあります。 クレジットとライセンス の各話者の「公式ページ」から VOICEVOX 公式サイトのキャラクターページと提供元の規約を必ず確認してください。
なぜ Discord 連携が必要なのですか?
1 Discord アカウントにつき 1 Gateway アカウントとすることで、API キーの乱発を防ぐためです。 API キーの名前は <Discord ID>_<alias> 形式になり、運営が利用者を識別できます。
入力したテキストや音声は保存されますか?
保存しません。入力テキスト、AudioQuery、生成された音声はログにも DB にも残しません。 記録するのは endpoint・HTTP ステータス・送受信バイト数・所要時間などの統計と、キーの管理情報だけです。 なお、このサイトの公開ページ(概要・始め方など)の閲覧状況だけは Google Analytics で計測しており、 API とサインイン後の画面は計測対象外です(プライバシーポリシー)。
429 が返ってきたらどうすればよいですか?
利用量(直近 60 分で 1,000 units)か、同時実行数
(4)の上限に達しています。Retry-After の秒数だけ待つか、
RateLimit-Remaining を見てリクエスト間隔を調整してください。詳しくは
利用量の上限 を参照してください。
VOICEVOX エディタから接続できますか?
エディタは認証ヘッダを送れませんが、固定 IP であれば IP 許可リスト に登録すると API キーなしで接続できます(サーバー / Bot / 固定回線向け)。IP が変わる端末からは利用できないため、 その場合は HTTP クライアント、Bot、サーバーサイドのアプリケーションから API キーを送って利用してください。
エンジンが停止していたらどうなりますか?
音声合成は 502 upstream_unavailable(タイムアウトは 504)を返しますが、
ゲートウェイ自体は稼働を続けます。このサイトの各ページ、/docs、キー管理は利用できます。
API キーは複数作れますか?
用途ごとに複数作成できます。上限(1 キーあたり 1,000 units / 60 分)はキーごとに判定されるため、用途を分けると制限を有効に使えます。
Discord の連携を解除できますか?
ダッシュボードの「アカウント管理」から解除できます。API キーの名前は <Discord ID>_<alias> 形式で Discord ID を含み、キーの正当性は連携した Discord アカウントに紐づくため、解除と同時にそのアカウントの API キーは すべて失効します(失効したキーは元に戻せず、利用中のアプリは停止します)。 失効してよいことを確認してから実行してください。
アカウントを削除できますか?
はい。ダッシュボードの「アカウント管理」で GitHub ユーザー名を入力して確認すると削除できます。 API キーはすべて失効し、連携情報・利用統計・利用規約への同意記録も削除されます (復元できません)。不正利用の防止のため、連携 ID のハッシュと削除記録だけを保持します。 詳細は プライバシーポリシー を参照してください。
古い利用規約に同意したままのキーはどうなりますか?
利用規約が改定されると、該当するキーは再同意が必要になります。その状態のキーで API を呼ぶと
403 terms_required が返るので、利用規約 を確認して
コンソールから再同意してください。
利用量が「無制限」になることはありますか?
管理者が必要と認めたキーには「無制限」を設定できます。無制限のキーは直近 60 分の利用量の上限判定を行いません(同時実行数の上限は引き続き適用されます)。 無制限でも利用量は記録されるため、利用状況 で消費量を確認できます。 利用者自身では変更できません。
403 / 401 が返って API キーが使えなくなったのはなぜですか?
目的別にいくつかあります。403 api_key_suspended は管理者による一時停止、
403 user_disabled はアカウントが管理者により無効化されている状態、
403 terms_required は新しい利用規約への同意が必要な状態です。
401 invalid_api_key はキーの誤り・失効(Discord 連携の解除や「再発行」で
失効した場合を含む)です。詳しくは API リファレンス のエラー一覧を
参照してください。