Skip to main content
Todos los casos de uso
Cobro de API por usoSaaS

Cobra por lo que costó la llamada. Devuelve el resto, automáticamente.

Extracta vende extracción de documentos como API — facturas, contratos y PDFs escaneados convertidos en JSON estructurado. Un recibo de una página y un contrato de cuarenta cuestan montos muy distintos de procesar, así que un precio fijo por llamada o cobra de más en el trabajo fácil, o pierde dinero en el difícil. Con Meter, el agente que llama firma un tope de gasto antes de que corra la llamada, Extracta mide las páginas y el tiempo de cómputo reales contra ese tope, y la diferencia no usada vuelve on-chain en el instante en que termina el trabajo. El recibo se resella con el número real, no con la estimación inicial.

AntesPrecio fijo por llamada → adivinar en cada trabajo
DespuésTope firmado → uso medido → saldo no usado se reembolsa on-chain
100%
del tope no usado reembolsado automáticamente
Pruébalo en el Sandbox
Signed cap
Antes de que corra la llamada
El agente que llama firma un tope por adelantado, nunca una cuenta abierta
Metered live
Contra el tope
Páginas procesadas, tokens gastados, tiempo de cómputo — el costo real del trabajo
On-chain refund
Saldo no usado devuelto
La diferencia entre el tope y el uso real se liquida de vuelta automáticamente
Resealed
Número real, no la estimación
El recibo cierra con lo que la llamada costó de verdad
Lo que muestra el recibo

La llamada cierra con lo que costó de verdad, no con el tope firmado.

Un trabajo de extracción, de punta a punta: el agente firma un tope de US$0,80 antes de que corra la llamada, la API de Extracta mide páginas procesadas y tiempo de cómputo contra ese tope, y en el instante en que termina el trabajo, el saldo no usado vuelve on-chain. El recibo se resella con el número real medido, no con el tope inicial.

  • El tope se firma antes de que corra la llamada — la API no puede cobrar por encima de él
  • El uso real, páginas procesadas y tiempo de cómputo, se mide contra el tope, no se estima
  • La diferencia no usada se reembolsa on-chain en el instante en que cierra el trabajo, sin factura, sin disputa

Extraer los ítems de un contrato de proveedor de 40 páginas, con un tope de US$0,80.

Firmando un tope de US$0,80 para este trabajo — midiendo las páginas procesadas contra él, y devolviendo lo que sobre cuando termine la extracción.

Llamada de API medida · extracción de documento
call_8f21 · Extracta /extract
Medido · reembolsado · sellado
Job40-page vendor contract → structured JSON
Tope firmado$0.80 · USDC
Uso medido$0.34 · 40 pages · 61s compute
Reembolsado$0.46 · on-chain · automatic
ReciboResealed at $0.34
receipt-call8f21.jsonusage-trace.json
medido · reembolsado · selladorcp_mtr8f21
El problema

La conversación es la parte fácil.

Las APIs cobradas por uso adivinan. Un precio fijo por llamada o cobra de más en los trabajos fáciles, o pierde dinero en los difíciles, y nadie lo descubre hasta que cierra la factura a fin de mes. Quien vende infla el precio para cubrir el peor caso; quien llama paga por capacidad que nunca usó; disputar una diferencia es un ticket de soporte, no un protocolo.

Cobrar cada llamada a precio fijo, inflado para cubrir el peor caso

El agente firma un tope de gasto del tamaño del trabajo real, antes de correr

Perseguir una diferencia en los trabajos difíciles con una factura manual

codespar_meter mide el uso real contra el tope mientras corre la llamada

Dejar que quien llama pague de más en cada trabajo fácil para cubrir el promedio

La diferencia entre el tope y el uso real se reembolsa on-chain automáticamente

Conciliar a mano una llamada disputada contra los logs del servidor

El recibo se resella con el número medido, no con la estimación

Cómo lo hace el agente

Precio por llamada, liquidado por el loop de máquina.

codespar_meter firma el tope de gasto antes de que corra la llamada, mide el uso real mientras la API ejecuta, y liquida la diferencia on-chain en el instante en que termina el trabajo. Meter no tiene precio propio — corre dentro de la liquidación de codespar_pay, así que Extracta paga la misma tarifa del 1% de Gate sobre el monto real medido, no sobre el tope.

01
Solicitar
API de Extracta

Trabajo de extracción enviado

02
Firmar tope
codespar_meter

Tope de US$0,80 firmado

Meter
03
Procesar
Motor de Extracta

40 páginas · 61s de cómputo

04
Medir uso
codespar_meter

US$0,34 medidos contra el tope

Meter
05
Liquidar y reembolsar
codespar_pay

US$0,46 reembolsados on-chain · recibo resellado

Liquidación Gate
Arquitectura

El agente que llama abre una sesión y firma un tope de gasto antes de que corra la extracción. La API de Extracta mide el uso real — páginas procesadas, tiempo de cómputo — contra ese tope mientras el trabajo ejecuta. Cuando termina, codespar_pay liquida sobre el monto medido y reembolsa el saldo no usado on-chain automáticamente; el recibo se resella con el número real bajo la tarifa de liquidación del 1% de Gate. Este loop de máquina está construido de punta a punta y mergeado, corriendo en beta detrás de una bandera mientras terminan las últimas corridas de verificación en mainnet.

En código

Unas pocas líneas. Todo el loop.

metered-api-access.ts
const session = await codespar.sessions.create();

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,
});

// Extracta reports real usage back through the same cap
await session.execute("codespar_meter", {
  capToken: job.capToken,
  usage: { pages: 40, computeSeconds: 61 },
});

// codespar_pay settles on the metered amount, refunds the rest on-chain
const receipt = await session.execute("codespar_pay", { capToken: job.capToken });
// receipt.amount === "$0.34" · receipt.refunded === "$0.46" · sealed
100% · selladoreceipt · rcp_metere
Herramientas destacadas
codespar_meter

Firma el tope de gasto antes de que corra la llamada y mide el uso real contra él mientras el trabajo ejecuta.

codespar_pay

Liquida sobre el monto medido y reembolsa el tope no usado on-chain, bajo la tarifa del 1% de Gate.

codespar_ledger

Resella el recibo con el número real medido en cuanto cierra el uso.

Ver la referencia de meta-tools
Servidores MCP conectados

Ponlo en marcha esta misma tarde.

Abre el sandbox, apunta una sesión a tus proveedores y corre todo el loop contra rails reales en minutos — no en el trimestre que toma construirlo a mano.

Acceso a API medido por uso — CodeSpar | CodeSpar