# 플랜 사용량 측정 방식

> URL: https://foura.ai/ko/docs/guides/plans-and-metering
> Updated: 2026-11-11
> Index: https://foura.ai/llms.txt

FourA는 두 가지 제품을 제공하며, 각 제품은 서로 다른 단위로 측정됩니다. 요금제는 두 단위 중 하나를 기준으로 판매되며, 이에 따라 사용량 한도 초과 여부와 대시보드에 표시되는 카드가 결정됩니다. 이 페이지는 전체 모델을 한눈에 볼 수 있도록 정리한 내용입니다.

## 두 가지 제품, 두 가지 단위

| 제품 | 호출 대상 | 단위 |
|---------|----------|----------|
| API | `POST /api/single`, `/api/proxy`, `/api/browser`, `/api/auto` | request 단위, 크레딧으로 가격 책정 |
| Proxy 포트 | proxy URL을 지원하는 모든 클라이언트의 `proxy.foura.ai:34004` | 터널 단위, 기가바이트(GB)로 가격 책정 |

API에서는 `success` 결과에 대해서만 크레딧이 차감됩니다. 타깃 측, 사용자 측 또는 FourA 측의 오류로 실패한 request에는 크레딧이 부과되지 않습니다. 프리미엄 트래픽은 아래 설명된 대로 크레딧과 별도로 계산됩니다. [Request 결과](https://foura.ai/docs/api/outcomes)를 참고하십시오.

Proxy 포트에는 크레딧과 request 수 측정 기준이 없으며, 이는 의도된 설계입니다. 터널은 사용자의 도구가 여는 단일 연결이며 내부에서 전송되는 데이터는 자체 암호화된 트래픽이므로, FourA는 터널과 전송된 바이트 수만 측정할 수 있고 그 이상의 세부 내용은 확인할 수 없습니다. 여기서 request 수를 계산하면 사용자의 자체 로그와 일치시킬 수 없는 수치가 됩니다. 따라서 포트는 항상 기가바이트 단위로 판매됩니다. [Proxy 포트](https://foura.ai/docs/api/proxy-port)를 참고하십시오.

## 기가바이트(GB)의 정의 및 포함 항목

1 기가바이트는 1,073,741,824 바이트(2^30, GiB로도 표기되는 단위)를 의미합니다. 요금제의 모든 허용량, 카운터 및 가격은 API와 proxy 포트 모두에서 이 수치를 기준으로 사용합니다.

두 제품이 전송하는 대상이 다르므로 측정되는 항목도 제품에 따라 다릅니다.

| 위치 | 측정 항목 |
|-------|-----------------|
| API, 표준 출구 | FourA로 전송한 request body와 FourA가 반환하는 response body의 합산. 양방향 모두 HTTP header는 계산되지 않습니다. |
| API, 프리미엄 출구 | 네트워크를 통과한 전송 데이터의 모든 바이트(양방향, 전송 중 압축 및 암호화된 상태 기준). |
| Proxy 포트 | 터널이 열린 후 터널을 통과하는 모든 바이트(양방향, 클라이언트가 사이트와 수행하는 암호화 연결 설정 포함). 터널을 여는 과정은 계산되지 않으나, 포트가 터널을 여는 동안 시도했지만 사용하지 않은 프리미엄 출구는 프리미엄 트래픽으로 계산됩니다. |

참고해야 할 몇 가지 주요 사항:

- **페이지는 디코딩된 상태로 집계됩니다. 디코딩된 페이지가 당사가 생성하는 최종 결과물이기 때문입니다.** 해당 페이지에 도달하려면 실제 브라우저를 실행하고, 페이지가 요구하는 추가 단계를 완료한 후, 응답을 디코딩하여 사용 가능한 콘텐츠로 전달해야 할 수 있습니다. 결제 대상은 이 결과물 자체이며, 전송 중 압축 수준이 아닙니다. 프록시 포트는 반대 사례이며 다른 방식으로 요금이 책정됩니다. 프록시 포트에서는 사용자의 자체 연결을 전달하고 내부 데이터는 건드리지 않으므로, 터널을 통과하는 바이트를 그대로 정확히 집계합니다.
- **표준 풀에서의 재시도는 추가 비용이 발생하지 않습니다.** Proxy Finder가 여러 출구를 순환할 때, 시도 횟수와 상관없이 수신한 응답에 대해 1회만 결제됩니다. 프리미엄 출구에서는 프리미엄 네트워크의 청구 방식에 따라 모든 시도가 집계됩니다.
- **표준 출구의 브라우저 세션은 일반 API 응답과 동일하게 집계됩니다.** 페이지가 로드한 모든 하위 리소스가 아니라 사용자에게 반환된 body 기준입니다. 프리미엄 출구를 통할 경우 세션 전체가 네트워크에 그대로 노출되며 전체 트래픽이 집계됩니다.
- **프리미엄은 전체 한도에 포함되며, 추가 항목이 아닙니다.** 표준 한도는 프리미엄 출구를 거치지 않은 트래픽 부분에 대해서만 차감됩니다.
- **Auto 호출 자체는 별도 트래픽을 유발하지 않습니다.** Auto가 생성하는 Single, Proxy Finder, Browser 요청은 사용자가 직접 요청한 것처럼 집계됩니다.
- **사이트의 거부는 집계되지만, 플랜 자체의 거부는 집계되지 않습니다.** 사이트가 403, 404, 429 또는 5xx로 응답하면 당사가 해당 응답을 사용자에게 전달했으므로 집계에 포함됩니다. 플랜 자체 한도 초과로 인해 요청이 거부되면 아무것도 가져오지 않으므로 집계되지 않습니다.
- **올림 처리는 전혀 적용되지 않습니다.** 바이트는 블록 단위나 요청당 최소 한도 없이 정확하게 집계되며, 사용량 수치는 매일 밤 당사의 지표 저장소와 대조 조정됩니다.

## 플랜 판매 방식 두 가지

모든 계정에 두 측정 기준이 모두 작동합니다. 플랜의 *판매 기준*이 무엇인지에 따라 차이가 발생합니다.

### 크레딧 기준 판매

API는 청구 대상 요청당 크레딧을 차감합니다. 터널에는 크레딧을 부과할 단일 요청 개념이 없으므로 프록시 포트에는 별도로 명시된 포함 기가바이트가 제공됩니다. 두 항목은 상호 영향을 주지 않습니다. API 트래픽은 포트의 기가바이트를 소모하지 않으며, 포트 터널은 크레딧을 소모하지 않습니다. 그렇지 않다면 하나의 API 요청에 대해 크레딧으로 한 번, 해당 크레딧이 생성한 바이트로 또 한 번, 총 두 번 과금하게 됩니다.

플랜에 별도 한도가 설정되어 있지 않다면 API 자체의 트래픽 한도는 꺼진 상태로 유지됩니다.

### 트래픽 기준 판매

단일 표준 트래픽 한도로 API와 프록시 포트를 함께 처리합니다. 두 진입점 모두 동일한 단위로 가격이 책정되기 때문입니다. 이 방식으로 판매되는 플랜은 크레딧을 청구하지 않으므로, 의미 없는 숫자를 표시하는 대신 대시보드에서 크레딧 항목이 완전히 제거됩니다.

### 두 방식 모두 적용되는 프리미엄 트래픽

프리미엄 트래픽은 두 플랜 유형 모두에서 항상 자체 한도를 가집니다. 표준 수치 내에 절대 합산되지 않으므로 1기가바이트가 두 한도에서 중복 차감되는 일은 없습니다. 프리미엄 출구는 `POST /api/proxy/` 또는 `POST /api/auto/`의 `exitClass: premium`을 통해, 또는 프록시 포트의 `-network-premium`를 통해 접근합니다.

네트워크를 통과하는 시점에 양방향 모두 압축 및 암호화된 상태 그대로 측정됩니다. API에서는 페이지를 반환하지 못한 시도를 포함하여 모든 프리미엄 시도가 반영됩니다. 프록시 포트에서는 각 프리미엄 터널의 트래픽과 포트를 열면서 시도했다가 취소된 프리미엄 출구 트래픽이 합산됩니다.

## 거부되는 항목 및 위치

| 허용량 | API | 프록시 포트 |
|-----------|-----------|-------------------|
| 해당 기간의 크레딧 | `429` (`X-FourA-Limit: plan_limit_credits` 포함) | 해당 없음 |
| 해당 기간의 표준 트래픽 | `429` (`X-FourA-Limit: plan_limit_bandwidth` 포함) | `429` (트래픽을 명시하는 `X-Foura-Error` 포함) |
| 동시 개방 터널 수 | 해당 없음 | `429` (`X-Foura-Error` 포함) |
| 분당 터널 개방 횟수 | 해당 없음 | `429` (`X-Foura-Error` 포함) |
| 프리미엄 트래픽 | `exitClass: premium`에서 다운그레이드됨. 고정된 프리미엄 프록시 ID는 `400` 수신. 출구 위치를 지정하는 Proxy 요청은 `403` (`plan_limit_premium` 포함) 수신 | 명시적 요청 시 `403` |

`CONNECT`에는 JSON 에러를 담을 body가 없으므로, 포트 거부는 [Rate Limits](https://foura.ai/docs/api/rate-limits)에서 설명하는 형태가 아니라 상태 코드와 헤더로 전달됩니다. 프록시 연결에서는 무엇보다 먼저 `X-Foura-Error`을 확인하십시오.

### 프리미엄 소진 시 발생하는 유일한 비대칭성

"사용 요청"과 "기존 설정"은 서로 다른 상황이므로 두 통로는 의도적으로 다르게 응답합니다.

API에서는 프리미엄 허용량을 모두 소진해도 `exitClass: premium`를 요청하는 요청이 중단되지 않습니다. 해당 요청은 표준 풀에서 처리되며 응답에 `exitClass: standard`가 표시되므로 실제로 수신한 결과를 확인할 수 있습니다. 유일한 예외는 [출구 위치](https://foura.ai/docs/api/endpoints#exit-location)를 지정하는 `POST /api/proxy/` 요청입니다. 표준 풀에서는 이를 수용할 수 없으므로 `403` 및 `plan_limit_premium`로 거부됩니다. 이후 요청에서 `proxy`로 고정된 프리미엄 프록시 ID는 다르게 동작합니다. 허용량이 소진되면 `400` 및 `Managed exit: this proxy id cannot be pinned to a request`로 거부되며, 새로운 `POST /api/proxy/` 호출을 통해 대신 고정할 표준 출구를 받게 됩니다. 프리미엄 출구가 전혀 포함되지 않은 플랜은 응답이 다르며, `403` 및 `plan_limit_premium`로 반환됩니다.

프록시 포트의 경우:

- `-network-premium`를 지정하는 연결은 `403`로 거부됩니다. 사용을 명시적으로 요청했으므로, 다른 곳에서 임의로 처리되면 반영되지 않는 프리미엄 내역을 대조해야 하는 문제가 발생합니다.
- 프록시 사용자에 저장된 프리미엄 기본 설정은 공유 네트워크로 다운그레이드되며 터널은 정상적으로 열립니다. 이번 연결에 대해 사용자가 직접 선택한 것이 아니기 때문입니다.
- 활성화된 `-fallback-premium`는 단순히 실행되지 않습니다.

## 추가 구매

충전분은 플랜에 포함된 기본 제공량과 완전히 동일하게 취급됩니다. 매 기간 플랜 자체의 허용량이 먼저 사용되며, 초과된 사용량에 한해서만 구매한 잔액에서 차감됩니다. 구매 내역은 12개월간 유지됩니다.

대시보드는 한도를 표시하는 모든 위치에서 두 수치를 구분하여(`1,300,000 (300,000 incl + 1,000,000 bought)`) 화면의 수치를 보유 중인 청구서와 대조할 수 있도록 합니다.

## 관련 수치 확인 위치

| 페이지 | 제공 정보 |
|------|-----------------|
| [Billing](https://foura.ai/docs/dashboard/billing) | 사용 가능한 수량 대비 이번 주기의 수치. 플랜에서 측정하는 항목별 카드 제공 및 충전 가능한 카드별 구매 버튼 제공 |
| [Usage & Limits](https://foura.ai/docs/dashboard/quota) | 실시간 카운터 옆에 표시되는 모든 제한 수치, 키별, endpoint별, proxy 사용자별 분석 내역 제공 |
| [Overview](https://foura.ai/docs/dashboard/overview) | 제품별, 모든 기간에 대한 볼륨 및 트래픽 |

Billing에 표시되는 카드는 위의 두 가지 경우를 따릅니다. 크레딧 단위로 판매되는 플랜에는 Credits 카드가 제공되며, Proxy port traffic 카드에는 해당 포트에 기본 포함된 기가바이트가 표시됩니다. 트래픽 단위로 판매되는 플랜에는 Credits 대신 Requests 카드가 제공되며, Proxy port traffic 카드에는 포트가 공유 풀에서 전송한 양이 표시되고, Standard traffic 카드에는 상한선과 함께 **The API and the proxy port together**가 표시됩니다.

이 수치들을 하드코딩하지 마십시오. 모든 API 거부 응답에는 거부 사유가 된 상한선이 포함되며, 모든 포트 거부 응답에는 `X-Foura-Error`에 해당 내용이 명시됩니다.

## 관련 항목

- [Rate Limits](https://foura.ai/docs/api/rate-limits): API의 모든 플랜 제한 body 및 header
- [Proxy Port](https://foura.ai/docs/api/proxy-port): 측정 방식, 응답 코드 및 사용자 이름 옵션
- [Request Outcomes](https://foura.ai/docs/api/outcomes): 요청 및 터널에서 과금되는 결과 유형
- [Billing & Subscriptions](https://foura.ai/docs/dashboard/billing): 플랜, 충전 및 청구서
- [Usage & Limits](https://foura.ai/docs/dashboard/quota): 플랜 대비 실시간 카운터
