Skip to content

docs(skill): model prices from the live catalog, not a hand-kept table #63

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
VickyXAI merged 1 commit into from
Oct 20, 2026
Merged

docs(skill): model prices from the live catalog, not a hand-kept table #63

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
44 changes: 36 additions & 8 deletions src/clawrouter_hermes/skills/clawrouter/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -177,12 +177,12 @@ openclaw models set openai/gpt-4o

ClawRouter classifies each request into one of four tiers:

- **SIMPLE** — factual lookups, greetings, translations → gemini-2.5-flash ($0.30/$2.50)
- **MEDIUM** — summaries, explanations, data extraction → kimi-k2.7 ($0.95/$4.00)
- **COMPLEX** — code generation, multi-step analysis → gemini-3.1-pro ($2/$12)
- **REASONING** — proofs, formal logic, multi-step math → grok-4-1-fast-reasoning ($0.20/$0.50)
- **SIMPLE** — factual lookups, greetings, translations → gemini-2.5-flash
- **MEDIUM** — summaries, explanations, data extraction → kimi-k2.7
- **COMPLEX** — code generation, multi-step analysis → gemini-3.1-pro
- **REASONING** — proofs, formal logic, multi-step math → grok-4-1-fast-reasoning

Prices are per 1M input/output tokens, on the default `auto` profile. Per-tier
These are the default `auto` profile's tiers. Per-tier
savings percentages are deliberately not quoted: the published figure is blended
across a stated workload mix, and a per-tier number invites comparison against a
baseline nobody wrote down. See
Expand All @@ -194,6 +194,34 @@ Rules handle ~80% of requests in <1ms. Only ambiguous queries hit the LLM classi

<!-- br:models.chatVisible -->88<!-- /br:models.chatVisible --> models including: claude-fable-5.1, claude-fable-5, claude-opus-5.5, claude-opus-5, claude-opus-4.8, claude-opus-4.7, claude-sonnet-5.5, claude-sonnet-5, claude-sonnet-4.6, gpt-6-astra, gpt-6-sol, gpt-6.1-sol, gpt-6-luna, gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna, gpt-5.6-terra-pro, gpt-5.6-sol-pro, gpt-5.6-luna-pro, gpt-5.5, gpt-5.4, gpt-5.1, gemini-4-argon, gemini-3.1-pro, gemini-3.5-flash, grok-4.7, grok-4.6, grok-4.5, grok-4.3, grok-build-0.1, deepseek-v4-pro, deepseek-v4-flash-vision-exp [vision], deepseek-v4.1-flash, deepseek-chat, glm-5.2, kimi-k3, minimax-m3, qwen3.8-max, qwen3.7-max, mistral-large-4 [vision], hy4-preview, and the curated free models (nemotron-3.5-lightning, laguna-xs-2.1, north-mini-code, nemotron-3-nano-omni-30b-a3b-reasoning [vision], nemotron-3-ultra-550b, llama-3.2-11b-vision [vision]).

## Model Prices — Look Them Up Live

Model prices move (vendors reprice, promos end), so this skill carries no model price table. Read the live catalog before you budget a call:

```bash
curl -s https://blockrun.ai/api/v1/models # Base
curl -s https://sol.blockrun.ai/api/v1/models # Solana
```

Each entry in `data[]` has an `id`, a `billing_mode` and a `pricing` object. All amounts are USD.

| `billing_mode` | `pricing` fields | Estimated cost of one call |
| --------------- | ---------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| `paid` (chat) | `input`, `output` per 1M tokens; optional `cache_read` / `cache_write` per 1M; optional `long_context` | `(input_tokens × input + output_tokens × output) / 1,000,000`, minimum $0.001, plus the $0.001 transaction fee |
| `free` | `input: 0`, `output: 0` | $0 — no payment |
| `per_image` | `per_image`, `transaction_fee` | `per_image × images + transaction_fee` |
| `per_second` | `per_second`, `per_call_surcharge`, `transaction_fee`, `default_duration_seconds` | `per_second × seconds + per_call_surcharge + transaction_fee` |
| `per_track` | `per_track`, `transaction_fee` | `per_track + transaction_fee` |
| `per_character` | `per_1k_chars`, `transaction_fee` | `per_1k_chars × characters / 1,000 + transaction_fee` |
| `per_generation`| `per_generation`, `transaction_fee` | `per_generation + transaction_fee` |

- **Cached prompt tokens** bill at `cache_read` instead of `input` (and cache writes at `cache_write`) when the model lists them.
- **`long_context`** is a list of tiers. When the prompt is larger than a tier's `threshold` (or equal to it, if `inclusive` is true), that tier's `input` / `output` / `cache_*` rates apply to the **whole** request.
- Image size/quality and video resolution can raise the media price above the listed base rate.
- The figure above is an estimate. The exact amount is quoted in the HTTP 402 challenge before anything is signed, so a call never settles above its quote.
- On the API-key rail (`api.blockrun.ai`, account credit) the same `pricing` rates apply with no transaction fee; read them from `https://blockrun.ai/api/v1/models`, since `api.blockrun.ai` needs your key even to list models.
- Human-readable rate card: https://blockrun.ai/pricing

## Built-in Agent Tools

In addition to LLM routing, ClawRouter exposes BlockRun's paid data APIs as ready-to-use OpenClaw tools. Every tool bills the rail you are already on — x402 USDC from the local wallet, or account credit when a `brk_…` key is configured — with no extra setup and no provider API keys. The only genuinely wallet-only surfaces are phone-number ownership and Polymarket trading.
Expand All @@ -215,9 +243,9 @@ Realtime prices and historical OHLC across every asset class. The agent should c

| Tool | Purpose | Price |
| --------------------------- | --------------------------------------------------------------------------- | -------------------- |
| `blockrun_image_generation` | 8 image models — GPT Image 1/2, Nano Banana / Pro, Seedream 5 Pro, Grok Imagine / Pro, CogView-4 | $0.015–$0.15 / image |
| `blockrun_image_edit` | Edit / inpaint existing image (openai/gpt-image-1) | $0.02–$0.04 / image |
| `blockrun_video_generation` | Grok Imagine + ByteDance Seedance (1.5-pro / 2.0-fast / 2.0) + Sora 2, 5–10s | $0.03–$0.30 / second |
| `blockrun_image_generation` | 8 image models — GPT Image 1/2, Nano Banana / Pro, Seedream 5 Pro, Grok Imagine / Pro, CogView-4 | per model — see [Model Prices](#model-prices--look-them-up-live) |
| `blockrun_image_edit` | Edit / inpaint existing image (openai/gpt-image-1) | per model — see [Model Prices](#model-prices--look-them-up-live) |
| `blockrun_video_generation` | Grok Imagine + ByteDance Seedance (1.5-pro / 2.0-fast / 2.0) + Sora 2, 5–10s | per model — see [Model Prices](#model-prices--look-them-up-live) |

### Prediction Markets (Predexon)

Expand Down
Loading