利用量の上限
以下はAPI キーごとの既定値で、このゲートウェイが実際に適用している値です。 運用状況により管理者が個別に変更する場合があります。
| 項目 | 既定値 | 説明 |
|---|---|---|
| 利用量 | 1,000 units / 60 分 |
直近 60 分の rolling window で判定します。
/audio_query や /synthesis は 1 unit、
/synthesis_morphing は 2 units、
/multi_synthesis は AudioQuery の個数分を消費します。
|
| 同時実行 | 4 | 1 つのキーで同時に処理できるリクエスト数です。 |
| 入力テキスト | 500 文字 | 1 リクエストあたりの上限。超過時は 413 request_too_large。 |
| 複数まとめて合成 | 10 件 | /multi_synthesis に渡せる AudioQuery の上限です。 |
| リクエスト本文 | 1.0 MiB | POST する JSON の最大サイズです。 |
| 音声合成の本文 | 96.0 KiB | AudioQuery の上限です。500 文字で約 85 KiB になります。 |
管理者が必要と認めたキーには「無制限」を設定できます。無制限のキーは利用量の上限判定を行いませんが、 利用量の記録は継続し、同時実行数の上限は引き続き適用されます。利用者自身では変更できません。
上限に達したとき
-
利用量を超えると
429 rate_limit_exceeded、同時実行数を超えると429 concurrency_limit_exceededを返します。 -
応答の
Retry-After(秒)だけ待つか、RateLimit-Remainingを見て リクエスト間隔を調整してください。 - 消費量は 利用状況 で確認できます。上限は利用者自身では変更できません。
リクエストの受け付け条件
- 認証は
Authorization: Bearer vvx_...(X-API-Keyも可)。両方を指定して値が異なる場合は 400 です。 - 登録した IP からは認証ヘッダなしで受け付けます(IP 許可リスト。利用量・同時実行数は紐づけたキーに計上されます)。
?api_key=形式は採用していません(ログや Referer への漏えいを避けるため)。-
エラー形式(
401 invalid_api_key、403 endpoint_blocked、404 not_found、502 upstream_unavailableなど)の全体は API リファレンス にまとめています。
公開 Web GUI
API キーなしで試せるブラウザ用の GUI を 音声を試す に用意しています。 こちらはキー単位の上限とは別に、生成間隔(2 秒に 1 回)、 1 日あたりの回数、同時実行数で制限されます。