Perguntas frequentes
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 de API é pré-pago, a menos que uma API Felo elegível possa usar créditos de assinatura Felo Pro. As chamadas da API de Modelo são sempre pagas com créditos de serviço denominados em USD.
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 | 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 e em cada página de modelo. Consulte Modelos e Preços para a fórmula e uma estimativa trabalhada.
Verifique seu saldo e recarregue
Abra Cobrança do Console. 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:
{
"status": 402,
"code": "INSUFFICIENT_CREDITS",
"message": "...",
"request_id": "..."
}O que fazer:
- Verifique o saldo em Cobrança do Console.
- Recarregue.
- 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 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 Pro da Felo não pagam pela API de Modelo nem pelos novos endpoints Felo OpenAPI sob /api/v1/data. Ambos exigem saldo pré-pago da plataforma.
A elegibilidade pode mudar. Verifique a Cobrança do Console 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 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, 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_idde qualquer erro relacionado - O valor da recarga e a referência de pagamento
Nunca envie sua chave da API completa.
Relacionado
Precisa de ajuda?
- Para dúvidas sobre API, cobrança e conta, fale com o suporte.
- Converse com os desenvolvedores da Felo no Discord.
- Confira nosso registro de alterações.
- Precisa de preços por volume ou ajuda com compras? Fale com vendas.
- Construindo com um LLM? Leia o llms.txt.