Como funcionam os créditos da Optio — o modelo de custo da API Jev

A fórmula

Cada requisição custa ceil(tokens de entrada / 1,000) créditos, com mínimo de 1 crédito por chamada. Tokens de saída são sempre gratuitos — uma decisão são algumas dezenas de tokens, e você não é cobrado por eles. Se uma requisição falha (erro upstream, timeout, sobrecarga do provedor), nada é cobrado: os créditos são reservados antes de o modelo rodar, e a reserva é devolvida em caso de falha.

Antes da chamada, o gateway reserva uma estimativa a partir do seu payload a cerca de 4 caracteres por token. Depois da chamada, ele liquida contra a contagem real de tokens de entrada do relatório de usage do modelo, então a entrada do ledger reflete a verdade, não a estimativa. Você vê os três números — estimativa, real, cobrança — em usage.input_tokens, usage.credits e no ledger.

Exemplos em tamanhos reais

• Checagem sim/não em um ticket de uma linha, ~150–300 tokens de entrada → 1 crédito.
• Triagem de suporte: ticket mais três perguntas (sim/não de urgência, choice de roteamento, score de frustração), ~400–500 tokens → 1 crédito.
• Guardrail de agente sobre uma tool call em JSON com um parágrafo de política no state, ~1,600 tokens → 2 créditos.
• Triagem de currículos com o CV completo no state, ~8,000 tokens → 8 créditos.

A regra de lote escondida nesses números: como o mínimo é por requisição, não por pergunta, até 8 perguntas sobre o mesmo estado não custam mais de 1 crédito sempre que o total ficar abaixo de 1,000 tokens. Dividir o mesmo trabalho em chamadas por pergunta custa várias vezes mais.

Os pacotes

• Starter — $10 → 100,000 créditos. $0.0001 por decisão de crédito mínimo.
• Pro — $100 → 1,000,000 créditos. Mesmo preço por crédito; os ganhos são limites de taxa mais altos (600 vs 120 req/min, 10 vs 3 concorrentes) e menos recargas.
• Team — $1,000 → 11,000,000 créditos. Um bônus de 10% mais colaboração: colegas convidados compartilham o saldo.
• Free — todo novo workspace começa com 5 créditos, e o playground é gratuito no navegador (ele nunca toca nos créditos).

Créditos nunca expiram e nunca migram entre workspaces. Um mês quieto custa $0 — não há assinatura para planejar o uso em volta dela.

Limites de taxa por plano

Concorrência e requisições por minuto seguem o melhor plano do workspace:

• Free: 20 req/min, 1 requisição concorrente.
• Starter: 120 req/min, 3 concorrentes.
• Pro: 600 req/min, 10 concorrentes.
• Team: 2,000 req/min, 30 concorrentes.
• Enterprise: 6,000 req/min, 100 concorrentes — por negociação.

Exceder qualquer um dos limites retorna 429 com um cabeçalho Retry-After mais X-RateLimit-Remaining e X-RateLimit-Reset — o sinal seguro para recuar antes de tentar de novo.

Orçando a partir do tráfego

Como a cobrança é determinística — só a contagem de tokens — a sua conta é previsível: decisões diárias × créditos médios por decisão. Se metade das suas decisões fica no mínimo de 1 crédito e 50,000 rodam por dia, são cerca de 50,000 créditos, aproximadamente $5/dia nos preços do Starter. Carregar o pacote Team reduz o preço efetivo por crédito em cerca de um terço (11M créditos por $1,000 vs 1M por $100).

Dois hábitos de contabilidade que economizam dinheiro

Primeiro, agrupe as suas perguntas. Se uma requisição carrega um sim/não mais uma choice e um score sobre o mesmo estado (a triagem de suporte como uma única requisição), ela é cobrada uma vez sob o mínimo de 1 crédito. Enviar as mesmas três como três requisições cobra 3 créditos. Até oito perguntas viajam juntas, então monte o state uma vez e pergunte tudo sobre o que você poderia ramificar.

Segundo, corte o state, não as perguntas. A cobrança conta os tokens de entrada do payload inteiro, então colar um documento de 20,000 caracteres no state para fazer uma pergunta de uma linha sobre ele domina a fatura — ceil(20,800/1,000) = 21 créditos em vez de 1. Se só um parágrafo importa, extraia o parágrafo você mesmo antes de enviar; o modelo faz a leitura que você mandar, mas a contagem de tokens é escolha sua.

Quando dois créditos vencem um

• Um documento de política de 2,400 tokens buscado uma vez e reutilizado entre decisões — se você fizer três perguntas em uma requisição sobre ele, paga 3 créditos uma vez em vez de reenviá-lo em três chamadas de uma pergunta (9 créditos pelo mesmo trabalho).
• Um currículo de ~8,000 tokens triado uma vez para 8 must-haves: 8 créditos em uma única requisição com 8 perguntas, contra 8 chamadas de 8 créditos cada se o state tivesse que viajar separadamente em cada requisição...
• Na verdade essa comparação se repete: o state só viaja nas requisições que o precisam. A alavanca real é o mínimo de 1 crédito: abaixo de 1,000 tokens, perguntas extras são gratuitas; acima disso, cada kilobyte de state é mais 0.25 créditos.

O que aparece no ledger

Cada requisição liquidada escreve uma linha no ledger do dashboard: reservado (estimativa), cobrado (tokens de entrada reais / 1000, min 1), request_id, e qual chave de API gastou. Requisições com falha escrevem uma linha de reembolso com cobrança zero, então a conciliação de fim de mês é só filtrar por request_id. Se uma cobrança parecer errada, o suporte pode rastreá-la a partir do request_id nos seus logs — cite-o.