Skip to content

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

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(skills): model prices from the live catalog, not a hand-kept table #44

Show file tree
Hide file tree
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
24 changes: 13 additions & 11 deletions skills/imagegen/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -56,16 +56,18 @@ Display inline: `![generated image](http://localhost:8402/images/abc123.png)`

### Model Selection

| Alias | Full ID | Price | Sizes | Best for |
| ------------------ | ---------------------------- | ------------ | ------------------------------- | ----------------------------------- |
| `nano-banana` | `google/nano-banana` | $0.05 | 1024×1024, 1216×832, 1024×1792 | Default — fast, cheap, good quality |
| `banana-pro` | `google/nano-banana-pro` | $0.10–$0.15 | up to 4096×4096 | High-res, large format |
| `dalle` | `openai/dall-e-3` | $0.04–$0.08 | 1024×1024, 1792×1024, 1024×1792 | Photorealistic, complex scenes |
| `gpt-image` | `openai/gpt-image-1` | $0.02–$0.04 | 1024×1024, 1536×1024, 1024×1536 | Budget option; supports editing |
| `flux` | `black-forest/flux-1.1-pro` | $0.04 | 1024×1024, 1216×832, 832×1216 | Artistic styles, fewer restrictions |
| `grok-imagine` | `xai/grok-imagine-image` | $0.02 | 1024×1024 | xAI Grok image style |
| `grok-imagine-pro` | `xai/grok-imagine-image-pro` | $0.07 | 1024×1024 | Grok high-quality |
| `cogview` | `zai/cogview-4` | $0.015–$0.02 | 512×512 to 1440×1440 | Cheapest — Zhipu CogView |
| Alias | Full ID | Sizes | Best for |
| ------------------ | ---------------------------- | ------------------------------- | ----------------------------------- |
| `nano-banana` | `google/nano-banana` | 1024×1024, 1216×832, 1024×1792 | Default — fast, cheap, good quality |
| `banana-pro` | `google/nano-banana-pro` | up to 4096×4096 | High-res, large format |
| `dalle` | `openai/dall-e-3` | 1024×1024, 1792×1024, 1024×1792 | Photorealistic, complex scenes |
| `gpt-image` | `openai/gpt-image-1` | 1024×1024, 1536×1024, 1024×1536 | Budget option; supports editing |
| `flux` | `black-forest/flux-1.1-pro` | 1024×1024, 1216×832, 832×1216 | Artistic styles, fewer restrictions |
| `grok-imagine` | `xai/grok-imagine-image` | 1024×1024 | xAI Grok image style |
| `grok-imagine-pro` | `xai/grok-imagine-image-pro` | 1024×1024 | Grok high-quality |
| `cogview` | `zai/cogview-4` | 512×512 to 1440×1440 | Cheapest — Zhipu CogView |

**Prices:** per image, and they change — look the model up live instead of trusting a number here. `GET https://blockrun.ai/api/v1/models` (Solana: `https://sol.blockrun.ai/api/v1/models`), find the entry whose `id` is the Full ID above, and read `pricing.per_image` plus `pricing.transaction_fee`. Larger sizes or higher `quality` can cost more than the listed base rate; the exact amount is quoted in the HTTP 402 challenge before anything is signed.

**Choosing a model:**

Expand Down Expand Up @@ -113,7 +115,7 @@ Response is identical to generation:
}
```

**Supported models for editing:** `openai/gpt-image-1` only ($0.02)
**Supported models for editing:** `openai/gpt-image-1` only

---

Expand Down
37 changes: 32 additions & 5 deletions skills/xclawrouter/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -41,12 +41,12 @@ openclaw models set openai/gpt-4o

XClawRouter 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-k3 ($3/$15)
- **COMPLEX** — code generation, multi-step analysis → gemini-3.1-pro ($2/$12)
- **REASONING** — proofs, formal logic, multi-step math → deepseek-reasoner ($0.14/$0.28)
- **SIMPLE** — factual lookups, greetings, translations → gemini-2.5-flash
- **MEDIUM** — summaries, explanations, data extraction → kimi-k3
- **COMPLEX** — code generation, multi-step analysis → gemini-3.1-pro
- **REASONING** — proofs, formal logic, multi-step math → deepseek-reasoner

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.
Expand All @@ -57,6 +57,33 @@ Rules handle ~~80% of requests in <1ms. Only ambiguous queries hit the LLM class

<!-- br:models.chatVisible -->88<!-- /br:models.chatVisible --> models including: claude-fable-5.1, claude-fable-5, claude-opus-5.5, claude-opus-5, claude-sonnet-5.5, claude-sonnet-5, gpt-6-astra, gpt-6-sol, gpt-6.1-sol, gpt-6-luna, gpt-5.6-terra, gpt-5.6-sol, gpt-5.5, gpt-5.4, gpt-5.1, gemini-3.1-pro, gemini-3.6-flash, grok-4.7, grok-4.6, grok-4.5, grok-4.3, glm-5.3, kimi-k3, qwen3.8-max, qwen3.7-max, mistral-large-4, hy4-preview, laguna-s-2.1, mimo-v2.5, deepseek-v4-pro, deepseek-chat, and the free models (nemotron-3.5-lightning [default], 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], muse-glimmer-30b).

## 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.
- Human-readable rate card: https://blockrun.ai/pricing

## Example Output

```
Expand Down
Loading