従量課金型AIチャージ:利用枠の確保、同時減算、残高照合
従量課金AIではチャージだけでなく、各タスクの予約・実使用量・残高変化を照合する必要があります。加盟店側台帳の設計順序を示し、同時要求、上流タイムアウト、未完了タスクを扱います。計測項目は実際のAI提供者仕様に従います。
目次
1. サービスと状態の定義を明確にする
AIサービスでは前払い残高、ポイントパック、定期利用、従量課金を併売することがあります。チャージ額は決済記録、ポイントは加盟店定義の単位、トークンや呼出量は実計測に基づき、同じ残高ではありません。表示前に各台帳の単位・出所・利用範囲を定義します。
2. 注文と購入した権利を紐づける
注文作成時にユーザーとワークスペースの紐付け、商品・ポイントパック版、金額、通貨、チャージ単位、規則版を保存します。決済後は合意したチャージ台帳へ記録します。決済額を提供者のトークン量のように表示せず、ブラウザーから任意の付与量を受け入れません。
3. サーバー側で確認してから処理する
各モデルタスクに一意のIDと照合可能な利用記録を付けます。実際の料金ルールに合う場合は先に枠を確保し、終了後に確認済みの入力・出力・計測単位で精算して差額を戻します。タスクと台帳更新を原子的または再試行可能にし、成功時の未請求や失敗時の過剰請求を防ぎます。
4. 例外を振り分け、照合記録を残す
複数タスクが同じ残高を読んで超過利用しないよう、条件付き原子減算、行ロック、直列台帳を使います。上流応答がタイムアウトしたらタスクIDで最終利用量を照会し、確認前に再減算・再送しません。不明額は確認待ちとして保留し、手動照合経路を用意します。
5. 公開前の確認リスト
少額チャージ、決済通知重複、残量不足、同時呼出し、モデル拒否、上流タイムアウト、取消、一部利用、返金を試験します。決済、チャージ台帳、予約、実使用、返却、ワークスペース、最終残高を照合します。APIキーはサーバーの管理された設定に置き、ログではマスキングします。
6. よくある質問
入金額、ポイント、トークン数は固定比率で換算できますか?
加盟店が換算ルールを明示し実際に採用している場合に限ります。モデル、計量方式、提供者価格は異なるため、規則版と適用時刻を保存し、現金残高・ポイント・実使用量を別々に記録します。
同時リクエストが成功表示でも残高がずれるのはなぜですか?
残高を読み取ってから別々に減算すると、複数リクエストが同じ利用可能額を使う場合があります。原子的な減算またはロック付きトランザクションを使い、必要なら先に予約し、実使用分を精算して残りを戻します。
上流呼び出しがタイムアウトしたら、すぐ返金・再減算しますか?
クライアントのタイムアウトだけでは提供側が実行していない証拠になりません。加盟店ジョブIDで信頼できる利用量・結果を照会し、不明状態は保留して重複呼出しを防ぎます。失敗確認後に予約を戻し、成功確認後に実使用量を精算します。
業務範囲
加盟店側の台帳設計ガイドであり、稳付payやモデル提供者が特定の利用量照会・事前承認・自動返金APIを提供するという意味ではありません。料金単位、状態項目、データ元は各提供者に確認してください。