AI provider or your application
- Runs or routes the AI request
- Returns vendor usage and cost when available
- Performs custom workflows and product actions
- Continues to own provider availability
UsageTap Meter
Control AI usage by customer—before cost becomes a surprise.
Connect calls, tokens, agent actions, and custom product events to customer accounts. Apply plan allowances before expensive work runs, show customers their current and predicted usage, and send validated totals to Stripe.
Customer and feature usageStatus in policy
One-prompt Meter setup
Point your coding agent at Meter
Use one prompt to inspect your existing provider calls, choose the right SDK or HTTP path, implement Meter safely, and hand back the exact keys and Meter configuration steps.
The agent asks only when it cannot safely infer the customer identity or integration target. Gateway and Compress stay out of the first implementation.
Open the canonical agent referencePaste into your coding agent
Implement UsageTap Meter in this repository.
Read https://usagetap.com/llmreference first and treat it as the canonical contract. The initial goal is Meter only. Do not add UsageTap Gateway, UsageTap Compress, prompt compression, provider migration, model changes, or Stripe synchronization unless I explicitly ask.
Work autonomously:
1. Inspect the repository to find every server-side AI/provider call, the framework/runtime, existing provider SDKs, streaming behavior, tests, environment-variable conventions, and the trusted authenticated customer or tenant ID.
2. Choose the smallest safe integration. Prefer @usagetap/sdk for supported server-side JavaScript/TypeScript provider clients. Use the explicit SDK lifecycle when BLOCK or DOWNGRADE must control provider invocation or model selection; provider wrappers do not invent a safe fallback model. Use direct HTTPS for other languages or when the SDK is not a safe fit. Preserve the existing provider, model, request/response shape, and error behavior.
3. Ask one concise clarification only if a stable server-trusted customerId cannot be inferred or there are multiple materially different integration targets. Otherwise proceed.
4. Implement the complete Meter lifecycle. Attribute every call to a stable customerId and feature; begin before provider work; inspect data.allowed before invoking the provider; do not end a denied call because call_begin already finalized it; finalize an allowed call exactly once on success, error, stream completion, cancellation, or abort; report the actual model and usage returned by the provider; sanitize error metadata; and use one unique idempotency key per logical call, reused only for its retries.
5. Keep all credentials server-side. Never read, print, log, or commit secret values. Add placeholders only to the project's example environment file. UsageTap Meter needs USAGETAP_API_KEY (create a utk-… key with usage:write at https://usagetap.com/configure#api-keys). Keep the app's existing provider key such as OPENAI_API_KEY, ANTHROPIC_API_KEY, or OPENROUTER_API_KEY.
6. Add or update focused tests and run the relevant test, lint, and type/build checks. If credentials are unavailable, finish and verify the code without attempting a live provider request.
When done, report:
- what you changed and which calls are now metered;
- the exact environment-variable names the user must set, without values;
- any one remaining user decision or action;
- the command or request that produces the first metered call;
- how to verify it at https://usagetap.com/embed-api?features=meter;
- the next Meter step: define customer plans, allowances, and limits at https://usagetap.com/quickstart.
Do not stop at a plan or code sample. Make the changes when it is safe to do so.Product walkthrough
See the customer usage experience working together.
Move from named customer usage to current allowances, forecasts, status, and plan controls in one short walkthrough.
The walkthrough is silent and loops automatically. A static dashboard is shown when reduced motion is preferred.
UsageTap in actionCustomer → usage → policy
Provider-neutral integration
Use any provider. Meter every customer consistently.
Meter OpenAI, Anthropic, Google, OpenRouter, self-hosted models, or any HTTP call. Use the direct SDK for agent actions, API requests, generated outputs, and other custom product events that never touch an LLM.
Read the full Meter SDK reference →Provider or route
Integration style
Your selection
Keep the OpenAI SDK and add the UsageTap SDK to meter usage.
Install
npm install @usagetap/sdk openaiOpenAI · UsageTap SDK
import OpenAI from "openai";
import { withMetering } from "@usagetap/sdk/openai";
const provider = new OpenAI({
apiKey: process.env.OPENAI_API_KEY,
});
const openai = withMetering(provider, {
apiKey: process.env.USAGETAP_API_KEY,
customerId: currentCustomer.id,
feature: "chat.reply",
});
const response = await openai.responses.create({
model: "gpt-5.6-luna",
input: prompt,
});Keep your providers and application. Connect usage to the business.
Providers continue to run AI calls and your application continues to run custom workflows. Stripe owns subscriptions, invoices, and payment. UsageTap owns the customer usage record and the policy around it.
UsageTap Meter
- Attributes usage to each customer
- Applies allowances and limits
- Shows customer-facing usage
- Forecasts runout and changing patterns
- Creates a validated usage record
Stripe or commerce platform
- Owns subscriptions
- Creates invoices
- Collects payments
- Manages payment methods
From event to trusted usage
The customer-facing control loop.
Meter
Know who used what.
Attribute calls, tokens, agent actions, and custom events to the correct customer, tenant, feature, or workflow.
Control
Stop expensive surprises before they happen.
Check allowances and limits before running costly AI work.
Forecast
See where usage is heading.
Estimate runout and see when customer behavior is accelerating or declining.
Synchronize
Send trusted usage to Stripe.
Synchronize validated usage while Stripe continues to own subscriptions, invoices, and payments.
Usage changes are business signals.
UsageTap gives your team the customer, feature, and usage context needed to investigate and respond.
Rapid increase
A customer may be adopting a new workflow, automating more work, approaching an upgrade, or generating abusive traffic.
Gradual decline
A customer may be experiencing seasonality, disengagement, reduced adoption, or early churn risk.
Approaching an allowance
A customer may need an upgrade, an overage path, or an earlier warning.
Cost rising faster than value
A model, workflow, or customer behavior may be creating margin pressure.
These patterns are starting points for investigation, not automatic classifications of traction, expansion, abuse, or churn.
Customer-facing usage
Show customers where they stand.
Put current consumption, remaining allowance, forecast, and status inside your product so customers can act before a limit becomes a surprise.
Infrastructure and extensibility
Technical depth when you are ready to evaluate it.
Start with one customer and usage unit, then fit Meter into the event, observability, and commerce systems you already run.
Custom meters and dimensions
Define calls, tokens, generated outputs, searches, audio minutes, agent actions, or another value unit, then attach customer, tenant, feature, and workflow context.
Event APIs and SDKs
Use the TypeScript SDK or plain HTTP to begin work, record completed usage, and query customer usage status.
OpenTelemetry and webhooks
Send operational telemetry to OTLP-compatible tools and deliver usage or policy events to the systems your team already runs.
Commerce outputs
Synchronize validated usage with Stripe today. Keep planned commerce integrations such as Paddle and Clerk separate from the available path.
Used in our own production products
FocusedFit.ai and AskPilot.io are operated by the UsageTap team.
Simple prepaid pricing
Meter real customer usage before you pay.
Start without a subscription or credit card. Meter includes 100,000 usage events free every month. After that, graduated rates start at $0.20 per 1,000 events and fall to $0.05 per 1,000 at scale, deducted from the same prepaid UsageTap Balance used across the product. These published Meter rates are all-in; no additional UsageTap percentage fee is added.
See all UsageTap pricingIncluded when you start
$0 to start
100,000 usage events free every month.
- Starter balance
- $10
- After free usage
- $0.20 / 1K eventsGraduated down to $0.05 / 1K
- Payment details
- Not required to start
FAQ
Clear boundaries before you integrate.
Does UsageTap replace an AI provider?+
No. Your provider continues to run or route the AI request. UsageTap attributes the resulting usage to a customer and applies your usage policy around the call.
Does UsageTap create invoices or collect payments?+
No. Stripe or your commerce platform continues to own subscriptions, invoices, payment methods, and payment collection. UsageTap sends validated usage to that system.
What can I meter?+
You can meter calls, tokens, agent actions, custom events, and product-specific usage units. Customer, tenant, feature, and workflow identifiers keep the record attributable.
Does UsageTap decide whether a usage change means churn or abuse?+
UsageTap surfaces the pattern and its customer and feature context. Your team investigates that context and decides what the change means and how to respond.
Connect one AI feature and see who is using it.
Start with calls or tokens, then add allowances, customer-facing usage, and Stripe synchronization as you grow.