Install

# Install: pip install revgrid
import os, revgrid
client = revgrid.RevGrid(api_key=os.environ["REV_API_KEY"])

// Install: npm install revgrid
import { RevGrid } from 'revgrid';
const client = new RevGrid({ apiKey: process.env.REV_API_KEY });

# No install. Set REV_API_KEY and you're ready.
curl -s -X POST https://rev.polsia.app/v1/meter \
  -H "Authorization: Bearer $REV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agent-001",
    "action":   "completion",
    "tokens":   2000,
    "outcome":  "success"
  }'

Log a task

# After your agent processes a request:
resp = client.meter(
    agent_id="agent-001",
    action="completion",
    tokens=2000,
    outcome="success",
    metadata={"customer_id": "customer-123", "campaign": "q2-outreach"},
)
print(f"Charged {resp.price.total_cents}¢  (event_id={resp.event_id})")

// After your agent processes a request:
const resp = await client.meter({
  agent_id:   'agent-001',
  action:     'completion',        // chat | completion | embedding | tool_call | image_gen | search
  tokens_in:  llmResponse.usage.prompt_tokens,
  tokens_out: llmResponse.usage.completion_tokens,
  outcome:    'success',            // success | failure
  metadata:   { customer_id: input.customerId, campaign: 'q2-outreach' },
});
console.log(`Charged ${resp.price.total_cents}¢  (event_id=${resp.event_id})`);

Expected output

{
  "event_id": "evt_8c1a2f3e",
  "price": {
    "total_cents": 42,
    "breakdown": {
      "base_fee_cents": 10,
      "token_cost_cents": 20,
      "outcome_bonus_cents": 12
    }
  },
  "event": {
    "customer_id": "customer-123",
    "agent_id":    "agent-001",
    "action":      "completion",
    "tokens":     2000,
    "outcome":     "success"
  }
}

You're logging tasks. Now wire up pricing.

Configure per-action pricing, set up webhooks, and explore the full API surface for outcome-based billing.

← Back to Developer Hub

Stay in the loop

Log your first task in 60 seconds

You're logging tasks. Now wire up pricing.