プランの計測方法
FourAは2つのプロダクトを提供しており、それぞれ異なる単位で計測されます。プランはいずれか一方の単位に基づいて提供され、これにより適用される上限やダッシュボードに表示されるカードが決まります。このページでは、その課金モデルの全体像をまとめています。
2つのプロダクト、2つの単位
| プロダクト | 呼び出し対象 | 単位 |
|---|---|---|
| API | POST /api/single, /api/proxy, /api/browser, /api/auto |
request(クレジット換算) |
| Proxyポート | プロキシURLに対応した任意のクライアントからのproxy.foura.ai:34004 |
トンネル(ギガバイト換算) |
APIでは、successの結果となった場合のみクレジットを消費します。ターゲット側、クライアント側、またはFourA側で失敗したrequestはクレジットを消費しません。プレミアムトラフィックは、後述のとおりクレジットとは別にカウントされます。Request Outcomesを参照してください。
Proxyポートにはクレジットやrequest数のカウントがありませんが、これは仕様です。トンネルはツールが開く1つの接続であり、内部で送信されるデータは暗号化されたユーザー独自のトラフィックであるため、FourAがカウントできるのはトンネルとその転送バイト数のみとなります。ここでrequest数をカウントしても、独自のログと照合することはできません。そのため、ポートは常にギガバイト単位で販売されます。Proxy Portを参照してください。
ギガバイトの定義とカウント対象
1ギガバイトは1,073,741,824バイト(2^30、GiBとも表記される単位)を指します。プランにおけるすべての許容量、カウンター、価格は、APIとProxyポートのどちらでもこの数値を使用します。
2つのプロダクトでは転送される内容が異なるため、カウント対象も異なります。
| 項目 | カウント対象 |
|---|---|
| API(標準出口) | FourAに送信されたrequestのbody、および返されるresponseのbody。HTTP headerはどちら側でもカウントされません。 |
| API(プレミアム出口) | ネットワークを経由した双方向の全転送バイト数(転送時の圧縮および暗号化された状態)。 |
| Proxyポート | トンネル確立後に双方向を通過する全バイト数(クライアントがサイトと行う暗号化接続のセットアップを含む)。トンネルの開設自体はカウントされませんが、トンネル開設時にポートが試行したものの使用されなかったプレミアム出口は、プレミアムトラフィックとしてカウントされます。 |
留意すべき影響は以下のとおりです。
- デコード後のページとしてカウントされます。提供する成果物がデコード後のページであるためです。 そこに到達するまでに、実ブラウザの実行、ページが要求する追加ステップの完了、レスポンスのデコード、利用可能なコンテンツの受け渡しを伴う場合があります。課金対象はその結果であり、転送時の圧縮率ではありません。プロキシポートは別ケースとなり、逆の課金方式が適用されます。プロキシポートではユーザー自身の接続をそのまま中継し、内部データには関与しないため、トンネルを通過したバイト数がそのままカウントされます。
- 標準プールでの再試行には費用がかかりません。 Proxy Finderが複数のイグジットをローテーションする場合、試行されたイグジット数に関係なく、受け取ったレスポンスに対して1回のみ課金されます。プレミアムイグジットでは、プレミアムネットワーク側の課金体系に基づき、すべての試行がカウントされます。
- 標準イグジットでのブラウザセッションは、他のAPIレスポンスと同様にカウントされます。 ページが読み込んだすべてのサブリソースではなく、返却されたボディのみが対象です。プレミアムイグジットを経由する場合は、セッション全体がワイヤ上に乗り、その全体がカウントされます。
- プレミアム枠は合計使用量の一部であり、追加加算ではありません。 標準枠からは、プレミアムイグジットを経由しなかった分のみが差し引かれます。
- Auto呼び出し自体に独自のトラフィックは発生しません。 内部で実行されるSingle、Proxy Finder、Browserのリクエストは、直接実行した場合と同様にカウントされます。
- サイトによる拒否はカウントされ、契約プランによる拒否はカウントされません。 サイトが403、404、429、5xxで応答した場合、その応答を中継しているためカウント対象です。プランの上限によりリクエストが拒否された場合、取得は行われず、何もカウントされません。
- 切り上げは一切行われません。 ブロックサイズやリクエストごとの最低単位はなく、バイト単位で正確にカウントされ、数値は毎夜メトリクスストアと照合されます。
プランの2つの提供形態
全アカウントで両方のメーターが稼働しています。プランの提供形態によって、どちらが課金基準になるかが異なります。
クレジット制での提供
APIは課金対象リクエストごとにクレジットを消費します。プロキシポートには個別のギガバイト枠が付与されます。トンネルにはクレジットを課金する単位となるリクエストが存在しないためです。両者が相互に消費されることはありません。APIトラフィックがポートのギガバイトを消費することはなく、ポートのトンネルがクレジットを消費することもありません。これらを分けない場合、1つのAPIリクエストに対し、クレジットと生成されたバイト数の両方で二重課金することになってしまいます。
プランに設定がない限り、API独自のトラフィック上限は無効です。
トラフィック制での提供
APIとプロキシポートの両方が、単一の標準トラフィック枠でカバーされます。両インターフェースが同一単位で価格設定されているためです。この形態で提供されるプランではクレジットが請求されないため、無意味な数値を表示するのではなく、ダッシュボードからクレジット項目自体が非表示になります。
両形態におけるプレミアムトラフィック
プレミアムトラフィックには、どちらのプラン形態でも常に独立した枠が設定されます。標準の数値内にカウントされることはないため、1ギガバイトが2重の上限に請求されることはありません。プレミアムイグジットを利用するには、POST /api/proxy/またはPOST /api/auto/でexitClass: premiumを指定するか、プロキシポートで-network-premiumを指定します。
ネットワークを通過した時点で測定されます。双方向とも、送受信時の圧縮および暗号化された状態のトラフィックが対象です。APIでは、ページが返されなかった試行を含め、すべてのプレミアム試行がカウントされます。proxyポートでは、各プレミアムトンネルのトラフィックに加え、ポートが開通試行中に接続を試みて破棄したプレミアムイグジットのトラフィックも加算されます。
拒否される条件と場所
| 許容量 | API | proxyポート |
|---|---|---|
| 当該期間のクレジット | 429(X-FourA-Limit: plan_limit_creditsを含む) |
該当なし |
| 当該期間の標準トラフィック | 429(X-FourA-Limit: plan_limit_bandwidthを含む) |
429(対象トラフィックを示すX-Foura-Errorを含む) |
| 同時オープン可能なトンネル数 | 該当なし | 429(X-Foura-Errorを含む) |
| 1分あたりのトンネルオープン数 | 該当なし | 429(X-Foura-Errorを含む) |
| プレミアムトラフィック | exitClass: premiumではダウングレード。固定されたプレミアムproxy IDは400を受信。イグジットロケーションを指定したProxyリクエストは403(plan_limit_premiumを含む)を受信 |
明示的なリクエストでは403 |
CONNECTにはJSONエラーを含めるbodyが存在しません。そのため、ポート拒否はRate Limitsで説明されている形式ではなく、ステータスとheaderで返されます。proxy接続では何よりもまずX-Foura-Errorを確認してください。
プレミアム枯渇時の非対称性
「消費を明示的に要求した」場合と「過去に何かが設定されていた」場合とでは状況が異なるため、2つの入口では意図的に異なる応答を返します。
APIでは、プレミアム許容量を使い切ってもexitClass: premiumを要求するリクエストは停止されません。リクエストは標準プールから処理され、実際に何が取得されたか確認できるようにレスポンスにはexitClass: standardが示されます。唯一の例外は、exit locationを指定したPOST /api/proxy/リクエストです。標準プールでは対応できないため、403およびplan_limit_premiumで拒否されます。以降のリクエストでproxyにより固定されたプレミアムproxy IDの場合は異なり、許容量を使い切ると400およびManaged exit: this proxy id cannot be pinned to a requestで拒否され、新しいPOST /api/proxy/呼び出しによって固定対象の標準イグジットが代わりに提供されます。そもそもプランにプレミアムイグジットが含まれていない場合は別の応答となり、403(plan_limit_premiumを含む)が返されます。
proxyポートの場合:
-network-premiumを指定した接続は403で拒否されます。明示的に消費を要求しているため、別の場所から暗黙的に提供されると、発生しないはずのプレミアム明細を照合することになってしまいます。- proxyユーザーに保存されたプレミアムデフォルト設定は共有ネットワークにダウングレードされ、トンネルは開いたままになります。今回の接続のために明示的に選択されたわけではないためです。
- 有効化された
-fallback-premiumは単純に発火しません。
追加購入
追加チャージ分は、プランに含まれる枠と全く同様にカウントされます。各期間において、まずプラン自体の許容量が優先して使用され、超過した分のみが購入した残高から引き落とされます。購入分の有効期間は12か月です。
ダッシュボードでは、許容量を表示するすべての箇所でこれら2つの数値を分けて管理しているため (1,300,000 (300,000 incl + 1,000,000 bought))、画面上の数値を手元の請求書と照合できます。
数値の確認場所
| ページ | 確認できる内容 |
|---|---|
| Billing | 今期の使用量と利用可能枠の対比。プランの計測対象ごとにカードが表示され、チャージ可能なカードには「Buy」ボタンが配置されます |
| Usage & Limits | 各種制限値とリアルタイムのカウンター、キー別、endpoint別、proxyユーザー別の内訳 |
| Overview | 任意の期間におけるプロダクトごとのリクエスト量とトラフィック |
Billingに表示されるカードは、上記の2つのケースに準じます。クレジット単位のプランではCreditsカードが表示され、そのProxy port trafficカードにはポート固有の付属ギガバイト数が記載されます。トラフィック単位のプランでは、Creditsの代わりにRequestsカードが表示され、Proxy port trafficカードには共有プールからポートが消費したトラフィックが表示されます。また、Standard trafficカードには上限が記載され、The API and the proxy port togetherと表示されます。
これらの数値をハードコードしないでください。API拒絶時には拒絶理由となった上限値が必ず返され、ポート拒絶時にはX-Foura-Error内にその上限名が明記されます。
関連情報
- Rate Limits: APIのすべてのプラン制限に関するボディとheader
- Proxy Port: 計測、レスポンスコード、およびユーザー名オプション
- Request Outcomes: リクエストおよびトンネルにおける課金対象の結果
- Billing & Subscriptions: プラン、チャージ、請求書
- Usage & Limits: プランに対するリアルタイムのカウンター