Monetização por uso,em dois loops.
O loop de máquina assina um teto, mede o uso real, e reembolsa a diferença on-chain — verificável, sem precisar confiar. O loop humano cobra via Pix recorrente sobre o uso acumulado, e uma assinatura fixa é simplesmente esse mesmo loop com o uso mantido constante.
Liquidação de exemplo, números ilustrativos. Cada chamada real assina seu próprio teto e reembolsa contra seu próprio uso medido.
Preço fixo em trabalho de custo variável sai errado pra alguém, sempre.
APIs cobradas por uso — chamadas de LLM, processamento de documento, computação — não conseguem precificar um trabalho de forma justa antes de rodar. O custo real varia muito de chamada pra chamada, então um preço fixo ou cobra demais nos trabalhos fáceis ou absorve o prejuízo nos difíceis, e discutir uma diferença depois vira chamado de suporte, não protocolo.
- Precificar toda chamada de forma fixa, inflada pra cobrir o pior caso
- Subprecificar um trabalho difícil e absorver o prejuízo calado
- Cobrar demais em cada trabalho fácil só pra cobrir a média
- Reconciliar uma cobrança contestada na mão, batendo com log de servidor
- O agente assina um teto de gasto do tamanho do trabalho real, antes de rodar
- O uso real — páginas, tokens, tempo de computação — é medido contra o teto enquanto o trabalho roda
- A diferença não usada é reembolsada on-chain assim que o trabalho termina
- O recibo é reselado com o número medido, não a estimativa
Teto assinado entra, reembolso on-chain sai.
Preço justo é fácil; teto justo é difícil. O agente pré-autoriza um teto assinado, você cobra o que foi medido, e a diferença volta on-chain. Ninguém precisa confiar no seu medidor porque o reembolso é verificável.
O loop, em ordemAssina o teto. Mede a chamada. Reembolsa o resto.
O agente que chama assina um teto de gasto antes do trabalho rodar — um limite rígido, não uma estimativa. A API mede o uso real contra esse teto enquanto executa, e o codespar_pay liquida no valor medido, reembolsando a diferença não usada on-chain assim que o trabalho termina.
const session = await codespar.sessions.create(); // the cap is signed before the call runs — the API // can't charge past it, no matter how the job goes const job = await session.execute("codespar_meter", { cap: 0.80, currency: "USDC", metric: "pages_processed", provider: "extracta", }); const result = await extracta.extract({ file: contractPdf, capToken: job.capToken, }); // real usage is reported back through the same cap token await session.execute("codespar_meter", { capToken: job.capToken, usage: { pages: 40, computeSeconds: 61 }, }); // settles on the metered amount, refunds the rest on-chain const receipt = await session.execute("codespar_pay", { capToken: job.capToken, });
O que essa cadeia de chamadas faz
- Assina um teto de gasto antes do job rodar — a API nunca cobra além dele
- Mede o uso real enquanto o provider faz o trabalho, reportado de volta pelo mesmo cap token
- codespar_pay liquida pelo que foi realmente medido, não pelo teto original
- Devolve a diferença não usada on-chain, no momento em que o job termina
Qualquer unidade mensurável funciona como métrica.
Páginas processadas, tokens consumidos, segundos de computação — o Meter não liga pro que você está medindo, só que o teto segure e a diferença reembolse.
Esquerda: o caso de negócio real, ao vivo em Acesso medido a APIs. Direita: ilustrativo — o mesmo mecanismo, uma métrica diferente.
Dois loops no spec. Um está ao vivo hoje.
O loop de máquina acima está construído de ponta a ponta, mergeado, e rodando em beta atrás de uma flag. O loop humano — cobrança via Pix recorrente sobre uso acumulado, onde uma assinatura fixa é só esse mesmo loop com o uso mantido constante — vem a seguir.
- Agente assina um teto antes da chamada rodar
- Uso é medido contra esse teto assinado
- A diferença não usada é reembolsada on-chain, automaticamente
- O recibo é reselado com o número real medido
- Uso acumulado liquidando sob um mandato Pix recorrente
- Uma assinatura fixa é o mesmo loop, só que com o uso mantido constante — não é um produto separado
- Cobrança de humanos em vez de agentes, em BRL
Meter não tem preço próprio.
Medir é grátis e ilimitado. Não cobra nada sozinho. Alimenta a taxa do que liquida no Gate, o mesmo 1% (sem piso, teto R$2,00) de qualquer outra chamada com paywall.
BetaBeta, atrás de uma flag.
GA Disponibilidade geral segue as últimas rodadas de verificação Sepolia e mainnet.
Veja o acesso medido dentro de um caso de negócio real
Acesso medido a APIs
Pré-autoriza um teto por chamada, mede o uso real contra a cotação e devolve o saldo não usado antes de selar o recibo.
Ver o caso de negócio →Meter, respondido
O loop de máquina — teto assinado, uso medido, reembolso on-chain, recibo reselado — está ao vivo em beta, atrás de uma flag. O loop humano, cobrança via Pix recorrente sobre uso acumulado, vem a seguir.
A diferença é reembolsada on-chain e o recibo é reselado com o número real.
Não. O teto é um limite assinado que o agente pré-autorizou. É o limite, não uma estimativa.
Não. É grátis e ilimitado. A receita vem da taxa do Gate sobre o que liquida, não da medição em si.
Uso acumulado liquidando sob um mandato Pix recorrente, pra cobrar humanos em vez de agentes. Está no roadmap de curto prazo.
Depois que as últimas rodadas de verificação Sepolia e mainnet terminarem.
A API ou serviço que está fazendo o trabalho. Ele chama o codespar_meter com o uso realmente medido assim que o trabalho termina, e é esse número que a liquidação usa.
Não. Assim que o uso é reportado, o codespar_pay liquida no valor medido e reembolsa a diferença não usada on-chain automaticamente — sem fatura, sem disputa.
Precifique o que só dá pra saber depois que roda.
Teto assinado, uso real, reembolso on-chain, recibo reselado.
meter: Beta, atrás de uma flag.