diff --git a/README.md b/README.md index a19974c..baf9429 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ ### Cut your LLM bill by 88%. One line of TypeScript. -The smart-routing SDK for 71 models — every request goes to the cheapest model that can handle it, +The smart-routing SDK for 70 models — every request goes to the cheapest model that can handle it, paid per-request in USDC. No API keys. No subscriptions. No vendor lock-in. [![npm](https://img.shields.io/npm/v/@blockrun/llm.svg?style=flat-square)](https://www.npmjs.com/package/@blockrun/llm) @@ -41,7 +41,7 @@ console.log(r.response); // the proof ## Why This SDK - 🧠 **Smart routing that pays for itself** — the bundled [Router Core V3](https://github.com/BlockRunAI/router-core) engine (shared with [ClawRouter](https://github.com/BlockRunAI/ClawRouter)) classifies every request locally in <1ms across 15 dimensions and routes to the cheapest capable model. The main event. -- 🆓 **6 genuinely free models** — NVIDIA-hosted, $0 in and out, incl. 1M-context DeepSeek V4 Flash and a multimodal Nemotron. No rate-limit gimmicks. +- 🆓 **5 genuinely free models** — NVIDIA-hosted, $0 in and out, incl. 1M-context DeepSeek V4 Flash and a multimodal Nemotron. No rate-limit gimmicks. - 🔐 **No API keys** — your wallet signature is your authentication. No accounts, no dashboards, no key rotation. - 💸 **Pay per request in USDC** — x402 micropayments on Base or Solana. $5 covers thousands of requests; agents can pay their own way. - 🛡️ **Automatic failover** — transient errors (timeouts, 429, 5xx) walk the router's ranked fallback chain instead of failing your request. @@ -53,8 +53,8 @@ console.log(r.response); // the proof | | OpenAI SDK | OpenRouter | LiteLLM | **@blockrun/llm** | | ------------------ | -------------- | ----------------- | ---------------- | ----------------------------------------------------------------------- | | **Cost routing** | ✗ one vendor | Manual selection | Manual selection | **Automatic — 88% cheaper** | -| **Models** | GPT only | 200+ | 100+ (BYO keys) | **71, one wallet** | -| **Free tier** | ✗ | Rate-limited | ✗ | **6 models, no signup** | +| **Models** | GPT only | 200+ | 100+ (BYO keys) | **70, one wallet** | +| **Free tier** | ✗ | Rate-limited | ✗ | **5 models, no signup** | | **Auth** | API key | Account + API key | Your API keys | **Wallet signature** | | **Payment** | Card + invoice | Credit card | BYO keys | **USDC per-request** | | **Agent-ready** | ✗ | ✗ | ✗ | **✓ — agents fund their own wallet** | @@ -247,7 +247,7 @@ const reply = await client.chat('nvidia/step-3.7-flash', 'hello', { | Profile | Strategy | Savings vs Opus 5 | Best For | |---------|----------|-------------------|----------| -| `eco` | Cheapest capable model — ranks the 6-model free NVIDIA tier first | **98%** | Cost-sensitive production, zero-cost testing | +| `eco` | Cheapest capable model — ranks the 5-model free NVIDIA tier first | **98%** | Cost-sensitive production, zero-cost testing | | `auto` | Best balance of cost/quality (default) | **88%** | General use | | `premium` | Top-tier models (OpenAI, Anthropic) | 0% | Quality-critical tasks | @@ -1064,7 +1064,7 @@ const free = await client.chat('nvidia/step-3.7-flash', 'Hello!'); | Profile | Description | Best For | |---------|-------------|----------| -| `eco` | Budget-optimized — ranks the 6-model free NVIDIA tier first | Cost-sensitive workloads, zero-cost testing | +| `eco` | Budget-optimized — ranks the 5-model free NVIDIA tier first | Cost-sensitive workloads, zero-cost testing | | `auto` | Intelligent routing (default) | General use | | `premium` | Best quality models | Critical tasks | @@ -1620,7 +1620,7 @@ The `AnthropicClient` wraps the official `@anthropic-ai/sdk` with a custom fetch ## Frequently Asked Questions ### What is @blockrun/llm? -@blockrun/llm is a TypeScript SDK that cuts LLM costs by up to 88% with built-in smart routing: every request is routed to the cheapest of 71 models (OpenAI, Anthropic, Google, xAI, DeepSeek, Moonshot, and more) that can handle it, then paid per-request in USDC via the x402 protocol — no API keys, no subscriptions, no vendor lock-in. +@blockrun/llm is a TypeScript SDK that cuts LLM costs by up to 88% with built-in smart routing: every request is routed to the cheapest of 70 models (OpenAI, Anthropic, Google, xAI, DeepSeek, Moonshot, and more) that can handle it, then paid per-request in USDC via the x402 protocol — no API keys, no subscriptions, no vendor lock-in. ### How does payment work? When you make an API call, the SDK automatically handles x402 payment. It signs a USDC transaction locally using your wallet private key (which never leaves your machine), and includes the payment proof in the request header. Settlement is non-custodial and instant on Base or Solana. diff --git a/brand-numbers.json b/brand-numbers.json index c505b24..df07a35 100644 --- a/brand-numbers.json +++ b/brand-numbers.json @@ -2,17 +2,17 @@ "$schema": "https://blockrun.ai/brand/numbers.schema.json", "version": 1, "models": { - "chatVisible": 71, + "chatVisible": 70, "totalVisible": 93, - "free": 6, - "freeWithheld": 19, + "free": 5, + "freeWithheld": 20, "image": 9, - "video": 6, + "video": 7, "music": 1, "speech": 5, "soundfx": 1, - "withFallback": 46, - "withFallbackAllEntries": 79 + "withFallback": 44, + "withFallbackAllEntries": 78 }, "clawrouter": { "dimensions": 15,