# Cobrança e créditos

Como os créditos de serviço são cobrados, quando recarregar e o que significa uma resposta 402.

O uso da API é cobrado de acordo com os termos aplicáveis. Os créditos gratuitos são limitados tanto em tempo quanto em quantidade. O uso pago da Model API é cobrado em créditos de serviço da plataforma denominados em USD; APIs elegíveis da Felo podem utilizar créditos da assinatura Felo Pro.

## Como a cobrança funciona

- Uma recarga compra **créditos de serviço**, não um saldo em dinheiro mantido pela plataforma.
- Os créditos são denominados em USD para que as cobranças possam ser expressas em dólares.
- As recargas começam em **US$ 1**. Não é necessária assinatura.
- Os créditos são usados apenas para compensar cobranças de API da plataforma. Eles não podem ser sacados nem trocados por dinheiro.
- Recargas concluídas não são reembolsáveis, incluindo créditos não utilizados, exceto quando a legislação aplicável obrigatória exigir o contrário.

O saldo da plataforma paga pela API de Modelo, pelo Data API de terceiros e pela Felo OpenAPI exclusiva da plataforma (`/api/v1/data`). As APIs Felo existentes (`/v2`) usam créditos Pro da Felo, um saldo separado.

## O que uma solicitação custa

A cobrança depende do endpoint:

| Superfície | Base de cobrança |
|---------|---------------|
| API de Modelo | Tarifas de tokens para entrada, saída e cache, além de quaisquer ferramentas cobradas; o multiplicador de desconto do canal se aplica |
| Data API | A base de cobrança publicada para aquele endpoint, que pode ser por solicitação bem-sucedida, por item retornado ou com base no uso real |
| APIs Felo (`/v2`) | Direitos da conta Felo e regras de crédito; se os créditos são descontados depende da operação |
| [Felo no Data API](https://openapi.felo.ai/pt-BR/docs/api-reference/openapi/billing.md) | Saldo da plataforma; por solicitação, resultado retornado ou página gerada |

Os preços dos modelos são exibidos por 1M tokens na [página de preços](https://openapi.felo.ai/pt-BR/pricing) e em cada página de modelo. Consulte [Modelos e Preços](https://openapi.felo.ai/pt-BR/docs/guides/models-and-pricing.md) para a fórmula e uma estimativa trabalhada.

## Verifique seu saldo e recarregue

Abra [Cobrança do Console](https://openapi.felo.ai/console/billing). O console mostra seu saldo de créditos atual, valores de recarga e registros de uso. Os métodos de pagamento disponíveis dependem da sua região e são mostrados no checkout.

## A resposta 402

Um 402 significa que o saldo não cobre a chamada:

```json
{
  "status": 402,
  "code": "INSUFFICIENT_CREDITS",
  "message": "...",
  "request_id": "..."
}
```

O que fazer:

1. Verifique o saldo em Cobrança do Console.
2. Recarregue.
3. Reenvie a solicitação. Um 402 não é um limite de taxa, então esperar não o resolverá.

Para uma tarefa assíncrona, um 402 no envio significa que a tarefa nunca foi criada. Verifique o endpoint de status da tarefa antes de reenviar.

## Cobrança versus limites de taxa

Esses são limites diferentes:

- **Créditos** limitam quanto você pode gastar. Ficar sem eles retorna 402.
- **Limites de taxa** limitam a velocidade com que você pode chamar. Exceder um deles retorna 429.

Veja [Erros, Limites e Novas Tentativas](https://openapi.felo.ai/pt-BR/docs/guides/errors-and-limits.md) para os cabeçalhos 429 e as regras de nova tentativa.

## Créditos Pro da Felo e APIs Felo

As APIs Felo sob `/v2` — Search, PPT Task, Mindmap, LiveDoc, Web Fetch, X Search, YouTube Subtitling, Landing Page e SuperAgent — **atualmente aceitam créditos de assinatura Felo Pro**.

Os créditos do Felo Pro **não** cobrem o uso da Model API nem dos novos endpoints do Felo OpenAPI em `/api/v1/data`. O uso pago dessas APIs é cobrado em créditos de serviço da plataforma.

A elegibilidade pode mudar. Verifique a [Cobrança do Console](https://openapi.felo.ai/console/billing) para ver seu saldo e uso atuais.

A isenção de limite de taxa de `/v2/chat` para contas com uma assinatura Felo paga efetiva é um benefício separado; ela não altera como as chamadas são cobradas.

### Regras de crédito por capacidade de v2

Usar os direitos da conta Felo não significa que toda chamada desconta créditos. A operação determina a regra:

| Operação | Créditos e limites |
|---|---|
| Chat com base em busca, extração web, legendas do YouTube | Listados como gratuitos por tempo limitado na referência v2; os direitos atuais da conta determinam a disponibilidade, e os limites de solicitação ainda se aplicam |
| Criação de mindmap | O endpoint v2 de geração de mindmap não desconta créditos do usuário |
| Conversas SuperAgent, geração de PPT | Não há um valor fixo uniforme de crédito por solicitação publicado; contate o suporte com o endpoint e `request_id` para permissões específicas da conta |
| Exportação de PPTX | Iniciar uma nova exportação solicita 10 créditos Felo; consultar uma exportação existente ou atualizar sua URL de download não inicia outra cobrança |

Veja [X Search](https://openapi.felo.ai/pt-BR/docs/api-reference/x-search.md) para os requisitos de assinatura do X e a cobrança por resultado. Essas regras se aplicam às APIs `/v2` originais. Os endpoints Felo sob `/api/v1/data` usam o saldo da plataforma e seus preços publicados.

Para inspecionar registros da carteira da plataforma pela API, veja [consultas de uso da carteira](https://openapi.felo.ai/pt-BR/docs/api-reference/openapi/billing.md#consulte-o-uso-da-carteira-pela-api), que exigem um token de login.

## Questões de cobrança

Para uma cobrança contestada ou uma recarga que não chegou, entre em contato com o suporte com:

- O e-mail da conta
- O horário aproximado da cobrança
- O `request_id` de qualquer erro relacionado
- O valor da recarga e a referência de pagamento

Nunca envie sua chave da API completa.

## Relacionado

- [Preços](https://openapi.felo.ai/pt-BR/pricing)
- [Modelos e Preços](https://openapi.felo.ai/pt-BR/docs/guides/models-and-pricing.md)
- [Erros, Limites e Novas Tentativas](https://openapi.felo.ai/pt-BR/docs/guides/errors-and-limits.md)
- [Termos da API](https://openapi.felo.ai/api-terms)
