Como acompanhar custo, limites e recibos de inferência
Diferencie reserva, uso medido e cobrança. Saiba consultar um recibo da RN, interpretar estados pendentes e evitar repetir uma chamada paga.
Rota Nacional · Publicado · Revisado
Tokens não contam toda a história
Um pedido pode reservar um valor antes da resposta e terminar com um consumo menor. A reserva protege o limite autorizado. A liquidação usa o contrato e o consumo que foi possível medir. Por isso, valor reservado e valor cobrado aparecem como informações diferentes.
Também há diferença entre o custo do provedor e o serviço da RN. Uma chave própria e uma chave fornecida podem seguir contratos distintos. Consulte a tarifa aplicável ao seu caso. Um campo sem informação não representa custo zero.
Recupere o estado antes de repetir
Quando há reserva no gateway, o cabeçalho X-RN-Inference-Receipt identifica o recibo. A rota /v1/inference/receipts permite consultar os registros autorizados do pagador. O painel também mostra recibos na gestão de inferência.
Uma conexão interrompida não prova que o provedor deixou de executar o pedido. Uso desconhecido pode permanecer pendente para conciliação. Consulte o recibo e o estado do recurso assíncrono antes de enviar o mesmo trabalho outra vez. A RN não repete automaticamente um envio nativo já feito.
Defina limites em mais de um nível
O limite de saída limita o tamanho da resposta solicitada. As cotas da organização controlam pedidos e tokens no período. Saldo e contrato controlam a autorização financeira. Esses controles se complementam; um não substitui o outro.
Arquivos e operações de leitura não são a mesma coisa que uma nova inferência. Lotes precisam de um contrato que represente seu processamento posterior; uma tarifa por token na criação não mede todo o trabalho do lote. Para investigar um erro, guarde o identificador do pedido e do recibo, sem colocar prompts ou chaves em logs públicos.
Perguntas frequentes
Reserva e cobrança são o mesmo valor?
Não necessariamente. A reserva cobre o teto autorizado. A liquidação considera o contrato e o uso medido; a diferença pode ser devolvida.
Uma falha de conexão autoriza repetir a chamada?
Não por si só. O provedor pode ter recebido o pedido. Consulte o recibo e o estado do trabalho antes de tentar novamente.
Continue a leitura
Gateway de IA sem trocar o modelo da sua aplicação
Centralize conexões de IA na RN sem converter o corpo de cada provedor. Entenda o endpoint nativo, o pool autorizado e os limites da migração.
Várias chaves de IA com isolamento por organização
Organize conexões de provedores por empresa. Veja como pausa, pesos, consentimento e vínculo de arquivos evitam misturar o uso de clientes.
Crédito de IA por Pix: como continuar depois do teste
Entenda a compra de crédito na RN, o saldo da organização e a cobrança por uso. O pagamento abre sobre a tarefa e mantém o contexto do trabalho.