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 da API no Felo API Platform é pré-pago. Você compra créditos de serviço denominados em dólares, e cada requisição é descontada desse saldo pela tarifa aplicável.

Como funciona a cobrança

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

O mesmo saldo de créditos paga chamadas de modelo, chamadas à Data API e chamadas às Felo APIs. Você não precisa de uma conta ou saldo separado para cada fornecedor.

Quanto custa uma requisição

A cobrança depende do endpoint:

Superfície	Base da cobrança
Model API	Tarifas por token de entrada, saída e cache, mais ferramentas cobráveis; o multiplicador de desconto do canal se aplica
Data API	A base de cobrança publicada para aquele endpoint, que pode ser por requisição bem-sucedida, por item retornado ou com base no uso real
Felo APIs (`/v2`)	A tarifa da saída daquele fluxo de trabalho

Os preços dos modelos são exibidos por 1M de tokens na página de preços e na página de cada modelo. Consulte Modelos e preços para ver a fórmula e um exemplo de estimativa.

Verifique seu saldo e recarregue

Abra o Console Billing. O console mostra seu saldo atual de créditos, os valores de recarga e os registros de uso. Os métodos de pagamento disponíveis dependem da sua região e são exibidos na finalização da compra.

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 no Console Billing.
Recarregue.
Reenvie a requisição. Um 402 não é um limite de requisições, então esperar não vai resolvê-lo.

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 requisições

São limites diferentes:

Créditos limitam quanto você pode gastar. Acabar com eles retorna 402.
Limites de requisições limitam a velocidade com que você pode chamar. Exceder um deles retorna 429.

Consulte Erros, limites e novas tentativas para ver os cabeçalhos do 429 e as regras de novas tentativas.

Assinaturas e créditos

O uso da API é sempre pago com créditos de serviço. O único comportamento de assinatura descrito nesta documentação é a isenção dos limites de requisições de /v2/chat para contas com uma assinatura Felo paga efetiva; ela não substitui os créditos de serviço.

Dúvidas sobre cobrança

Para uma cobrança contestada ou uma recarga que não chegou, fale com o suporte informando:

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 do pagamento

Nunca envie sua chave de API completa.