# Como Seu Plano É Medido

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

A FourA vende dois produtos, e eles são medidos em unidades diferentes. Seu plano é vendido em uma dessas duas unidades, o que define qual franquia impõe limites a você e quais cards você vê no dashboard. Esta página apresenta o modelo completo em uma única tela.

## Dois produtos, duas unidades

| Produto | O que você chama | A unidade |
|---------|------------------|-----------|
| API | `POST /api/single`, `/api/proxy`, `/api/browser`, `/api/auto` | Uma request, precificada em créditos |
| Porta de proxy | `proxy.foura.ai:34004` a partir de qualquer cliente que aceite uma URL de proxy | Um túnel, precificado em gigabytes |

Na API, apenas o resultado `success` consome créditos. Uma request que falhou no lado do destino, no seu lado ou no nosso não custa nada para você. O tráfego premium é contabilizado separadamente dos créditos, conforme descrito abaixo. Consulte [Resultados de requests](https://foura.ai/docs/api/outcomes).

Na porta de proxy não há créditos nem contagem de requests, e isso não é uma omissão. Um túnel é uma conexão que sua ferramenta abre, e o que ela envia internamente é o seu próprio tráfego criptografado; portanto, a FourA pode contar o túnel e os bytes trafegados, nada mais granular que isso. Uma contagem de requests aqui seria um número impossível de conciliar com seus próprios logs. Por isso, a porta é sempre vendida por gigabyte. Consulte [Porta de proxy](https://foura.ai/docs/api/proxy-port).

## O que é um gigabyte e o que está incluído nele

Um gigabyte equivale a 1.073.741.824 bytes (2^30, a unidade também indicada como GiB). Toda franquia, contador e preço do seu plano utiliza esse valor, tanto na API quanto na porta de proxy.

O que é contabilizado varia conforme o produto, pois os dois transportam dados diferentes:

| Onde | O que é contabilizado |
|------|-----------------------|
| API, saídas padrão | O body da request que você nos envia, somado ao body da response que retornamos. Os headers HTTP não são contabilizados, em nenhum dos lados. |
| API, saídas premium | Cada byte da transferência conforme trafegou pela rede, em ambas as direções, comprimido e criptografado durante o transporte. |
| Porta de proxy | Cada byte que atravessa o túnel, em ambas as direções, após a sua abertura, incluindo o estabelecimento da conexão criptografada que seu cliente realiza com o site. A abertura do túnel não é contabilizada, com a exceção de que uma saída premium que a porta tenta e não utiliza durante a abertura do seu túnel conta como tráfego premium. |

Algumas consequências que vale a pena saber:

- **A página é contabilizada decodificada, porque a página decodificada é o que produzimos.** Chegar até ela pode exigir executar um navegador real, concluir uma etapa extra solicitada pela página, decodificar a resposta e entregar a você conteúdo utilizável. O que você paga é por esse resultado, não pela forma compacta como ele trafegou. A porta de proxy é o outro caso e é precificada de outra forma: nela transportamos sua própria conexão e não alteramos o conteúdo interno, portanto contabilizamos os bytes exatamente como eles cruzam o túnel.
- **Tentativas extras no pool padrão não custam nada a você.** Quando o Proxy Finder faz rotação por várias saídas, você paga uma única vez, pela resposta recebida, não importa quantas saídas foram testadas. Em uma saída premium toda tentativa é contabilizada, pois é assim que as redes premium nos cobram.
- **Uma sessão de navegador em uma saída padrão é contabilizada como qualquer outra resposta de API**: o corpo que retornamos a você, não cada sub-recurso carregado pela página. Através de uma saída premium toda a sessão trafega na rede e é contabilizada ali.
- **O tráfego premium faz parte do seu total, não é um adicional a ele.** Sua franquia padrão é debitada apenas pela parte que não passou por uma saída premium.
- **Uma chamada Auto não consome tráfego próprio.** As requisições Single, Proxy Finder e Browser executadas por ela são contabilizadas como se você mesmo as tivesse feito.
- **Uma recusa pelo site é contabilizada; uma recusa pelo seu próprio plano não é.** Quando um site responde 403, 404, 429 ou 5xx, transportamos essa resposta até você, logo ela é contabilizada. Quando um limite do seu próprio plano recusa a requisição, nada é buscado e nada é contabilizado.
- **Nada é arredondado para cima.** Os bytes são contabilizados com exatidão, sem tamanho de bloco e sem mínimo por requisição, e seus números são reconciliados todas as noites com nosso armazenamento de métricas.

## Duas Formas de Comercialização de um Plano

Ambos os medidores funcionam para todas as contas. O que muda é a métrica pela qual o seu plano é *vendido*.

### Vendido por créditos

A API cobra créditos por requisição faturada. A porta de proxy recebe seus próprios gigabytes inclusos, cotados separadamente, porque um túnel não possui uma requisição para debitar um crédito. Os dois não interferem entre si: o tráfego da sua API não consome os gigabytes da porta, e os túneis da porta não consomem seus créditos. Cobrar uma única requisição de API duas vezes, uma em créditos e outra nos bytes gerados por esses créditos, seria a alternativa.

O limite de tráfego próprio da API fica desativado, a menos que seu plano inclua um.

### Vendido por tráfego

Uma franquia de tráfego padrão cobre a API e a porta de proxy em conjunto, pois ambas as portas de entrada são precificadas na mesma unidade. Um plano vendido desta forma não cobra créditos, portanto os créditos desaparecem completamente do painel em vez de exibir um número sem significado.

### Tráfego premium, em ambos

O tráfego premium sempre possui sua própria franquia, em qualquer tipo de plano. Ele nunca é contabilizado dentro do número padrão, portanto um gigabyte nunca é debitado em dois limites. Você acessa uma saída premium com `exitClass: premium` no `POST /api/proxy/` ou `POST /api/auto/`, ou com `-network-premium` na porta de proxy.

É medido à medida que cruza a rede: em ambas as direções, comprimido e criptografado no trânsito. Na API, toda tentativa premium conta, incluindo aquela que não retornou sua página; na porta do proxy, é o tráfego de cada túnel premium, além de qualquer saída premium que a porta tentou e descartou ao abri-lo.

## O que Recusa Você e Onde

| Franquia | Na API | Na porta do proxy |
|-----------|-----------|-------------------|
| Créditos do período | `429` com `X-FourA-Limit: plan_limit_credits` | Não aplicável |
| Tráfego padrão do período | `429` com `X-FourA-Limit: plan_limit_bandwidth` | `429` com `X-Foura-Error` identificando o tráfego |
| Túneis abertos simultaneamente | Não aplicável | `429` com `X-Foura-Error` |
| Aberturas de túnel por minuto | Não aplicável | `429` com `X-Foura-Error` |
| Tráfego premium | Rebaixado em `exitClass: premium`; um ID de proxy premium fixado recebe `400`; uma request de Proxy que especifica um local de saída recebe `403` com `plan_limit_premium` | `403` em uma request explícita |

Um `CONNECT` não possui body para incluir um erro JSON, motivo pelo qual uma recusa na porta é um status acompanhado de um header, em vez do formato que [Rate Limits](https://foura.ai/docs/api/rate-limits) descreve. Leia `X-Foura-Error` antes de qualquer outra coisa em uma conexão de proxy.

### O término do premium é a única assimetria

As duas portas respondem de forma propositalmente diferente, porque "eu pedi para consumir" e "algo foi configurado para mim uma vez" são situações distintas.

Na API, uma franquia premium esgotada não interrompe uma request que pede `exitClass: premium`. A request é atendida pelo pool padrão e a response informa `exitClass: standard`, para que você possa ver o que realmente recebeu. A única exceção é uma request `POST /api/proxy/` que especifica um [local de saída](https://foura.ai/docs/api/endpoints#exit-location): o pool padrão não pode atendê-lo, portanto ela é recusada com um `403` e `plan_limit_premium`. Um ID de proxy premium fixado com `proxy` em uma request posterior funciona de forma diferente: uma vez esgotada a franquia, ela é recusada com um `400` e `Managed exit: this proxy id cannot be pinned to a request`, e uma nova chamada `POST /api/proxy/` fornece uma saída padrão para fixar em substituição. Um plano que não inclui saídas premium tem uma resposta diferente: trata-se de um `403` com `plan_limit_premium`.

Na porta do proxy:

- Uma conexão que especifica `-network-premium` é recusada com um `403`. Você solicitou o consumo; portanto, ser atendido silenciosamente por outro local deixaria você tentando reconciliar uma cobrança premium que nunca é exibida.
- Uma configuração padrão premium salva no usuário do proxy é rebaixada para a rede compartilhada, e o túnel ainda é aberto. Você não a escolheu especificamente para esta conexão.
- Um `-fallback-premium` armado simplesmente não é acionado.

## Comprar Mais

Recargas contam exatamente da mesma forma que o incluído no plano. A cada período, a franquia do seu próprio plano é consumida primeiro, e apenas o excedente consome o saldo comprado. Uma compra dura doze meses.

O painel mantém os dois números separados sempre que indica uma franquia (`1,300,000 (300,000 incl + 1,000,000 bought)`), para que o valor na tela possa ser reconciliado com a fatura que você tem em mãos.

## Onde consultar seus próprios números

| Página | O que responde |
|------|-----------------|
| [Faturamento](https://foura.ai/docs/dashboard/billing) | Este período em relação ao que está disponível, um card para cada item medido pelo seu plano, com um botão Comprar em cada card que seu plano puder recarregar |
| [Uso e limites](https://foura.ai/docs/dashboard/quota) | Cada limite ao lado de seu contador em tempo real, além de um detalhamento por chave, por endpoint e por usuário de proxy |
| [Visão geral](https://foura.ai/docs/dashboard/overview) | Volume e tráfego em qualquer período, por produto |

Os cards exibidos em Faturamento seguem os dois casos acima. Um plano vendido por créditos recebe um card de Créditos, e seu card de tráfego de porta de proxy traz os gigabytes incluídos da própria porta. Um plano vendido por tráfego recebe um card de Requisições no lugar de Créditos, seu card de tráfego de porta de proxy mostra o que a porta consumiu do pool compartilhado, e seu card de tráfego Padrão traz o limite máximo e informa **A API e a porta de proxy juntas**.

Não codifique nenhum desses números de forma rígida. Toda recusa da API traz o teto que a recusou, e toda recusa de porta o identifica em `X-Foura-Error`.

## Relacionado

- [Rate Limits](https://foura.ai/docs/api/rate-limits): Cada corpo e header de limite de plano na API
- [Porta de proxy](https://foura.ai/docs/api/proxy-port): Medição, códigos de resposta e opções de nome de usuário
- [Resultados de requisições](https://foura.ai/docs/api/outcomes): Quais resultados são cobrados, para requisições e para túneis
- [Faturamento e assinaturas](https://foura.ai/docs/dashboard/billing): Planos, recargas e faturas
- [Uso e limites](https://foura.ai/docs/dashboard/quota): Seus contadores em tempo real em relação ao seu plano
