Aivis プレミアム＋追加使用量でAPIを安定運用する方法｜レート制限を超えるとどうなる？

皆さんこんにちは。
感情豊かな音声合成技術を誰もがかんたんに活用できる未来を目指す、Aivis Project です✨

音声合成APIをWebサービスやアプリに組み込むと、平常時は問題なく動いていても、アクセスが集中した瞬間にリクエスト数が増えることがあります。

このとき気になるのが、Aivis プレミアムのレート制限を超えたら、音声合成が止まってしまうのかという点です。

Aivis プレミアムは、1分間に10リクエストまでの範囲であれば、月間の文字数制限なく利用できる定額サブスクリプションです。
ただし、追加使用量を無効にしたまま定額枠を超えると、レート制限が回復するまでHTTP 429エラーが返されます。

そこで活用したいのが、2026年8月にリリースした追加使用量です。
追加使用量を有効にすると、定額枠を超えたリクエストだけ従量課金クレジットへ切り替え、音声合成を継続できます。

この記事では、Aivis プレミアムと追加使用量の仕組み、429・402エラーの違い、コストの考え方、実装時の対処方法まで順番に解説します📚

【結論】定額枠を超えたときの3つの状態

最初に、全体像を整理します。

1分間に10リクエスト以内
→ Aivis プレミアムの定額枠で処理

10リクエストを超過 ＋ 追加使用量が無効
→ HTTP 429が返り、レート制限の回復待ち

10リクエストを超過 ＋ 追加使用量が有効
→ 超過分だけ従量課金クレジットを消費して処理を継続

つまり、平常時は定額、アクセスが集中したときだけ従量課金という運用ができます。

ただし、追加使用量は無制限の後払い機能ではありません。
事前にチャージしたクレジットが不足している場合や、設定した月間利用上限に達した場合はHTTP 402エラーになります。

Aivis プレミアムと従量課金の違い

追加使用量を理解する前に、2つの料金体系を確認しておきましょう。

Aivis プレミアムは継続利用向けの定額サブスクリプション

Aivis プレミアムは、月額1,980円（税込）の定額サブスクリプションです。

1分間に10リクエストまでのレート制限内であれば、音声合成APIを月間の文字数制限なく利用できます。
毎月一定量の音声を継続的に生成するサービスでは、料金を予測しやすいことがメリットです。

ここでいうレート制限は、月間の合計リクエスト数ではありません。
短い時間にどれだけリクエストが集中したかで判定されます。

そのため、月間の利用量が少なくても、同じ1分間にリクエストが集中すれば定額枠を超える可能性があります。

従量課金は使った文字数に応じてクレジットを消費

従量課金は、1万文字あたり440円（税込）です。
あらかじめクレジットをチャージし、音声合成を行った文字数に応じて残高から差し引かれます。

クレジットは音声合成を行った分だけ消費されるため、利用量に応じて支出が変動します。

追加使用量は、超過分だけ従量課金へ切り替える仕組み

追加使用量を有効にしても、Aivis プレミアムの月額料金や定額枠が変わるわけではありません。

1分間に10リクエストまでの範囲は引き続き定額で、定額枠を超えたリクエストだけが従量課金の対象になります。

たとえば、平常時は定額枠に収まり、キャンペーンや配信イベントの時間帯だけリクエストが増えるサービスであれば、次のように使い分けられます。

平常時：Aivis プレミアムの定額枠を利用
ピーク時：定額枠を超えた分だけクレジットを消費

すべてのリクエストを従量課金にする必要がないため、コストを抑えながら、ピーク時の継続性も確保しやすいのが特徴です。

追加使用量を有効にする方法

追加使用量は、Aivis Cloud API ダッシュボード内の「Aivis プレミアム」管理ページから有効にできます。

1. Aivis Cloud APIダッシュボードへログインする

2. 左側のメニューから「Aivis プレミアム」を開く

3. 「追加使用量」の設定をオンにする

4. 従量課金クレジットの残高と月間利用上限を確認する

設定はアカウント単位で適用されます。
定額課金に設定したAPIキーだけでなく、今後公開を予定している「AivisSpeech Web」などにも共通して適用されます。

⚠️ 追加使用量をオンにするだけでは、クレジットは自動で増えません。利用前に必要なクレジットをチャージし、残高不足通知や月間利用上限も設定しておくことをおすすめします。

レート制限を超えると、429と402のどちらが返る？

追加使用量を使うときは、HTTP 429とHTTP 402を分けて考えることが重要です。

HTTP 429：リクエスト数の制限に到達

HTTP 429 Too Many Requestsは、短時間に送信したリクエスト数がレート制限へ到達したことを示します。

追加使用量が無効の状態でAivis プレミアムの定額枠を超えると、制限が回復するまで429が返されます。
追加使用量を有効にすると、Aivis プレミアムの10 RPM超過分は従量課金に切り替わるため、この定額枠超過を理由とする429を回避できます。

ただし、将来の仕様変更や別の保護制限などに備え、本番環境では429を受け取る可能性を考慮した実装を残しておくと安全です。

HTTP 402：従量課金を継続できない

HTTP 402 Payment Requiredは、従量課金クレジットで処理を続けられない状態を示します。

追加使用量が有効でも、次のいずれかに当てはまる場合は402が返されます。

429は時間の経過で回復する可能性がありますが、402は待つだけでは解消しません。
クレジットのチャージ、または月間利用上限の見直しが必要です。

追加使用量のコストを見積もる

追加使用量の費用は、定額枠を超えて従量課金へ切り替わったリクエストの文字数で決まります。

概算するときは、次の考え方が使えます。

追加使用量の概算料金
＝ 超過リクエストの合計文字数 ÷ 10,000文字 × 440円

たとえば、ピーク時間帯に定額枠を超えたリクエストが100件あり、1件あたりの平均文字数が100文字だった場合、従量課金の対象は合計1万文字です。概算料金は440円になります。

重要なのは、月間の総リクエスト数だけでなく、1分単位のピークと、その時間帯に送信される平均文字数を把握することです。

まずは実際の利用状況を確認し、通常時は定額枠へ収まるのか、どの時間帯に追加使用量が発生しているのかを見ながら月間利用上限を調整しましょう。

実装側でも429・402を適切に処理する

追加使用量を有効にした場合でも、APIを呼び出すアプリケーション側にはエラーハンドリングが必要です。

次のPythonコードでは、429が返ったときだけ待機して再試行し、402が返ったときはリトライを中止します。

import random
import time

import requests


SYNTHESIZE_URL = "https://api.aivis-project.com/v1/tts/synthesize"


def synthesize(payload, headers, max_retries=3):
    for attempt in range(max_retries):
        response = requests.post(
            SYNTHESIZE_URL,
            json=payload,
            headers=headers,
            timeout=(5, 120),
        )

        if response.status_code == 402:
            raise RuntimeError(
                "クレジット残高または月間利用上限を確認してください"
            )

        if response.status_code == 429:
            reset_seconds = response.headers.get(
                "X-Aivis-RateLimit-Requests-Reset"
            )
            wait_seconds = (
                float(reset_seconds)
                if reset_seconds is not None
                else 2 ** attempt
            )
            time.sleep(wait_seconds + random.uniform(0, 0.5))
            continue

        response.raise_for_status()
        return response.content

    raise RuntimeError("レート制限が続いているため音声合成に失敗しました")

429へ闇雲に連続リクエストを送ると、無駄なリクエストが増え、APIやアプリケーション側の負荷を高めます。
レスポンスヘッダーにリセットまでの秒数が含まれている場合はその値を優先し、含まれていない場合は待機時間を段階的に延ばしてください。

一方、402は同じリクエストを繰り返しても回復しません。
運用担当者へ通知し、クレジット残高と月間利用上限を確認する流れに切り替えましょう。

ダッシュボードとAPIで使用量を確認する

Aivis Cloud APIダッシュボードでは、期間内のリクエスト数・消費文字数・消費クレジットをグラフで確認できます。
日別・時間別の切り替えや、APIキーごとの絞り込みにも対応しているため、ピーク時間帯の把握に役立ちます。

また、音声合成APIのレスポンスヘッダーから、課金モードやレート制限の状態を取得できます。

X-Aivis-Billing-Mode
X-Aivis-Character-Count
X-Aivis-Credits-Used
X-Aivis-Credits-Remaining
X-Aivis-RateLimit-Requests-Limit
X-Aivis-RateLimit-Requests-Remaining
X-Aivis-RateLimit-Requests-Reset

長期的な集計には、使用量サマリーAPIも利用できます。

curl "https://api.aivis-project.com/v1/payment/usage-summaries?start_date=2026-08-01&end_date=2026-08-20" \
  -H "Authorization: Bearer $AIVIS_API_KEY"

GET /v1/payment/usage-summariesでは、APIキーごとのリクエスト数・文字数・消費クレジットを日次または時間別で取得できます。
認証には、APIキーまたはJWTアクセストークンをAuthorization: Bearerへ設定します。

本番環境では、次の3点を組み合わせると管理しやすくなります。

利用状況に合わせた料金体系の選び方

検証や不定期利用なら従量課金

利用量がまだ読めない場合や、特定の日だけ音声合成を使う場合は、従量課金から始めるとシンプルです。
使った文字数分だけクレジットを消費するため、小規模な検証にも向いています。

継続利用ならAivis プレミアム＋追加使用量

日常的にAPIを利用しつつ、時間帯によってアクセス数が変動するサービスでは、Aivis プレミアム＋追加使用量が有力な選択肢です。

通常時は定額枠を使い、ピーク時だけ従量課金へ切り替わるため、コストの予測しやすさとサービスの継続性を両立できます。

大規模運用や専有環境が必要なら個別に相談する

非常に高いリクエスト頻度が見込まれる場合は、請求書払いや利用量に応じたディスカウントが適用できる可能性があるため、直接Aivis Projectへご相談ください。

また、自社管理のGPU環境で多数の音声合成モデルを運用したい法人様には、エンタープライズ向け音声合成APIサーバーのCitorasもご案内しています。

よくある質問（FAQ）

Q. Aivis プレミアムへ加入した後も、従量課金のAPIキーを使えますか？

はい。
APIキーごとに従量課金と定額課金を選べるため、同じアカウント内で併用できます。開発・検証用と本番用など、用途に応じてAPIキーを分ける運用も可能です。

Q. ユーザー辞書APIやモデル検索APIも、定額枠を消費しますか？

現時点では、課金とサブスクリプションのレート制限の対象になるのは音声合成APIです。
ユーザー辞書APIやモデル検索APIなど、その他のパブリックAPIは無料で利用できます。

Q. チャージしたクレジットに有効期限はありますか？

はい。
チャージしたクレジットは、決済から180日後に期限切れとなります。
有効期限が近いクレジットから順番に消費されます。

Q. 1回のリクエストへ長文をまとめるほどお得ですか？

リクエスト数だけを見れば減らせますが、長文を不自然にまとめることはおすすめしません。
文章の区切り方は、生成速度やストリーミング再生、感情表現の自然さにも影響します。
料金だけでなく、実際の音声品質を確認しながら分割してください。

Q. APIの利用量は、どのくらい前までダッシュボードで確認できますか？

ダッシュボードのアナリティクスでは、最大60日間分のデータを表示できます。
日別・時間別の切り替えやAPIキーごとの絞り込みを使い、利用傾向やピーク時間帯を確認できます。

まとめ

Aivis プレミアムと追加使用量を組み合わせることで、平常時のコストを一定に保ちながら、アクセスが集中したときも音声合成を継続しやすい運用を実現できます✨

まずはダッシュボードで実際のリクエスト数とピーク時間帯を確認し、クレジット残高・通知しきい値・月間利用上限を運用に合わせて設定してみてください。

以上で、この記事はおしまいです。

Aivis ProjectやAivis Cloud APIに関してご不明点やご相談がある場合には、お問い合わせフォームよりお気軽にご連絡ください。