Tracking Events

Track usage events with the Python SDK

Track usage events to monitor AI consumption.

Basic Tracking

async with Client(api_key="your-api-key") as client:
    await client.track.track_usage(
        customer_id="customer_123",
        event_type="model_call",
        model="gpt-4",
        provider="openai",
        input_tokens=100,
        output_tokens=50,
        total_tokens=150,
    )

Advanced Tracking

await client.track.track_usage(
    customer_id="customer_123",
    event_type="model_call",
    model="gpt-4",
    provider="openai",
    input_tokens=100,
    output_tokens=50,
    total_tokens=150,
    cost_cents=25,
    latency_ms=1200,
    properties={
        "user_id": "user_456",
        "team_id": "team_eng",
    },
    idempotency_key="req_abc123",
)

Next Steps

On this page