Felo API PlatformFelo API Platform

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ícieBase de cobrança
API de ModeloTarifas de tokens para entrada, saída e cache, além de quaisquer ferramentas cobradas; o multiplicador de desconto do canal se aplica
Data APIA 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 APISaldo 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:

  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 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çãoCréditos e limites
Chat com base em busca, extração web, legendas do YouTubeListados 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 mindmapO endpoint v2 de geração de mindmap não desconta créditos do usuário
Conversas SuperAgent, geração de PPTNã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 PPTXIniciar 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_id de qualquer erro relacionado
  • O valor da recarga e a referência de pagamento

Nunca envie sua chave da API completa.

Relacionado

Precisa de ajuda?