Cobrança

A API não tem fatura própria. As execuções consomem a mesma carteira de créditos que o cliente já usa na Cavori para o WhatsApp, o simulador e as demais respostas de IA. Você não compra nem recarrega créditos pela API: isso é feito no portal da Cavori, pelo cliente.

Como o consumo é medido

• Consomem créditos POST /v1/chat/completions e o follow-up que o agente envia numa conversa da API, que gera uma execução própria (evento request.completed com follow_up_id). Listar modelos, abrir e consultar conversas, ler mensagens e consultar execuções não custam nada.
• Antes de cada execução a Cavori reserva créditos. Se a carteira não cobre a reserva, a chamada responde 402 insufficient_credits.
• Ao fim, a reserva é acertada pelo uso medido: o que não foi usado volta para a carteira.
• Se o cliente está sem plano ativo, a chamada responde 402 plan_inactive.

Consultar o custo de uma execução

GET /v1/requests/:id devolve três valores, todos como string decimal:

Campo	O que é
reserved_credits	O total reservado ao longo da execução. Não desconta o que foi devolvido.
charged_credits	O que foi cobrado de fato.
cost_usd	O custo da execução em dólares.

A diferença entre reserved_credits e charged_credits não é crédito ainda preso: a parte da reserva que não foi usada já voltou para a carteira. Use charged_credits para saber quanto a execução custou.

Uma execução que falhou antes de gastar algo pode ter charged_credits igual a 0.

Quem paga

Quem paga é o cliente da Cavori dono da integração, na carteira dele.