Quick Start Guide

COSTLENS_API_KEY=cl_your_key_here

npm install costlens

import { CostLens } from 'costlens';
import OpenAI from 'openai';

const openai = new OpenAI();
const costlens = new CostLens({ 
  apiKey: process.env.COSTLENS_API_KEY,
  autoOptimize: true,    // 🚀 Saves 50-80% on tokens
  smartRouting: true,    // 🚀 Routes to cheapest model
  enableCache: true,     // 🚀 Saves 80% on repeated queries
  costLimit: 0.10        // 🚀 Prevents budget overruns
});

// Wrap your client - savings happen automatically!
const tracked = costlens.wrapOpenAI(openai);

// Use it exactly like normal OpenAI
const result = await tracked.chat.completions.create({
  model: 'gpt-4',
  messages: [{ role: 'user', content: 'Hello!' }]
});
// ✅ Prompt optimized, routed to cheaper model, cached, and tracked!

import { CostLens } from 'costlens';
import Anthropic from '@anthropic-ai/sdk';

const anthropic = new Anthropic();
const costlens = new CostLens({ 
  apiKey: process.env.COSTLENS_API_KEY 
});

// Wrap and use
const tracked = costlens.wrapAnthropic(anthropic);

const result = await tracked.messages.create({
  model: 'claude-3-opus-20240229',
  max_tokens: 1024,
  messages: [{ role: 'user', content: 'Hello!' }]
});
// ✅ Done!