BlockRunAI · VickyXAI · Aug 29, 2026 · Aug 29, 2026
diff --git a/docs/api-reference/models.md b/docs/api-reference/models.md
@@ -1,6 +1,6 @@
 ---
 title: Models
-description: List and price 72 models across chat, image, video, music, and speech from one unified BlockRun API, with a flat 5% platform fee over provider rates.
+description: List and price 72 models across chat, image, video, music, and speech from one unified BlockRun API, at provider rates — no platform margin on chat tokens, only the flat $0.001 transaction fee.
 ---
 
 # Models
@@ -68,56 +68,72 @@ Released 2026-07-09 — three fixed tiers (Sol / Terra / Luna) replacing the sin
 | Model ID | Name | Input Price | Output Price | Context |
 |----------|------|-------------|--------------|---------|
 | `openai/gpt-5.6-sol` | GPT-5.6 Sol | $5.00/M | $30.00/M | 1M |
+| `openai/gpt-5.6-sol-pro` | GPT-5.6 Sol Pro | $5.00/M | $30.00/M | 1M |
 | `openai/gpt-5.6-terra` | GPT-5.6 Terra | $2.00/M | $12.00/M | 1M |
+| `openai/gpt-5.6-terra-pro` | GPT-5.6 Terra Pro | $1.00/M | $6.00/M | 1M |
 | `openai/gpt-5.6-luna` | GPT-5.6 Luna | $0.20/M | $1.20/M | 1M |
+| `openai/gpt-5.6-luna-pro` | GPT-5.6 Luna Pro | $0.10/M | $0.60/M | 1M |
 
 ### OpenAI GPT-5.5 Family
 
 Released 2026-04-23 — first fully retrained base since GPT-4.5.
 
 | Model ID | Name | Input Price | Output Price | Context |
 |----------|------|-------------|--------------|---------|
+| `openai/gpt-5.5-pro` | GPT-5.5 Pro | $30.00/M | $180.00/M | 1M |
+| `openai/chat-latest` | ChatGPT Instant (GPT-5.5) | $5.00/M | $30.00/M | 128K |
 | `openai/gpt-5.5` | GPT-5.5 | $5.00/M | $30.00/M | 1M |
 
 ### OpenAI GPT-5.4 Family
 
 | Model ID | Name | Input Price | Output Price | Context |
 |----------|------|-------------|--------------|---------|
-| `openai/gpt-5.4` | GPT-5.4 | $2.50/M | $15.00/M | 1M |
 | `openai/gpt-5.4-pro` | GPT-5.4 Pro | $30.00/M | $180.00/M | 1M |
+| `openai/gpt-5.4` | GPT-5.4 | $2.50/M | $15.00/M | 1M |
 | `openai/gpt-5.4-mini` | GPT-5.4 Mini | $0.75/M | $4.50/M | 400K |
-| `openai/gpt-5.4-nano` | GPT-5.4 Nano | $0.05/M | $0.40/M | 128K |
+| `openai/gpt-5.4-nano` | GPT-5.4 Nano | $0.20/M | $1.25/M | 1M |
 
 ### OpenAI GPT-5 Family
 
 | Model ID | Name | Input Price | Output Price | Context |
 |----------|------|-------------|--------------|---------|
-| `openai/gpt-5.3` | GPT-5.3 | $2.00/M | $12.00/M | 400K |
-| `openai/gpt-5.3-codex` | GPT-5.3 Codex | $2.00/M | $12.00/M | 400K |
-| `openai/gpt-5.2` | GPT-5.2 | $1.75/M | $14.00/M | 400K |
 | `openai/gpt-5.2-pro` | GPT-5.2 Pro | $21.00/M | $168.00/M | 400K |
+| `openai/gpt-5.2` | GPT-5.2 | $1.75/M | $14.00/M | 400K |
+| `openai/gpt-5.3` | GPT-5.3 | $1.75/M | $14.00/M | 128K |
+| `openai/gpt-5.3-codex` | GPT-5.3 Codex | $1.75/M | $14.00/M | 400K |
 | `openai/gpt-5-mini` | GPT-5 Mini | $0.25/M | $2.00/M | 200K |
 
 ### OpenAI O-Series (Reasoning)
 
 | Model ID | Name | Input Price | Output Price | Context |
 |----------|------|-------------|--------------|---------|
 | `openai/o1` | o1 | $15.00/M | $60.00/M | 200K |
-| `openai/o1-mini` | o1-mini | $1.10/M | $4.40/M | 128K |
 | `openai/o3` | o3 | $2.00/M | $8.00/M | 200K |
 | `openai/o3-mini` | o3-mini | $1.10/M | $4.40/M | 128K |
+| `openai/o4-mini` | o4-mini | $1.10/M | $4.40/M | 128K |
+
+### OpenAI GPT-4.1 / GPT-4o
+
+| Model ID | Name | Input Price | Output Price | Context |
+|----------|------|-------------|--------------|---------|
+| `openai/gpt-4o` | GPT-4o | $2.50/M | $10.00/M | 128K |
+| `openai/gpt-4.1` | GPT-4.1 | $2.00/M | $8.00/M | 128K |
+| `openai/gpt-4.1-mini` | GPT-4.1 Mini | $0.40/M | $1.60/M | 128K |
+| `openai/gpt-4o-mini` | GPT-4o Mini | $0.15/M | $0.60/M | 128K |
+| `openai/gpt-4.1-nano` | GPT-4.1 Nano | $0.10/M | $0.40/M | 128K |
 
 ### Anthropic Claude
 
 | Model ID | Name | Input Price | Output Price | Context |
 |----------|------|-------------|--------------|---------|
 | `anthropic/claude-fable-5` | Claude Fable 5 | $10.00/M | $50.00/M | 1M |
-| `anthropic/claude-opus-5` | Claude Opus 5 | $5.00/M | $25.00/M | 1M |
-| `anthropic/claude-opus-4.8` | Claude Opus 4.8 | $5.00/M | $25.00/M | 1M |
-| `anthropic/claude-opus-4.7` | Claude Opus 4.7 | $5.00/M | $25.00/M | 1M |
-| `anthropic/claude-opus-4.6` | Claude Opus 4.6 | $5.00/M | $25.00/M | 1M |
 | `anthropic/claude-opus-4.5` | Claude Opus 4.5 | $5.00/M | $25.00/M | 200K |
-| `anthropic/claude-sonnet-4.6` | Claude Sonnet 4.6 | $3.00/M | $15.00/M | 200K |
+| `anthropic/claude-opus-4.7` | Claude Opus 4.7 | $5.00/M | $25.00/M | 1M |
+| `anthropic/claude-opus-4.8` | Claude Opus 4.8 | $5.00/M | $25.00/M | 1M |
+| `anthropic/claude-opus-5` | Claude Opus 5 | $5.00/M | $25.00/M | 1M |
+| `anthropic/claude-sonnet-4.5` | Claude Sonnet 4.5 | $3.00/M | $15.00/M | 200K |
+| `anthropic/claude-sonnet-4.6` | Claude Sonnet 4.6 | $3.00/M | $15.00/M | 1M |
+| `anthropic/claude-sonnet-5` | Claude Sonnet 5 | $3.00/M | $15.00/M | 1M |
 | `anthropic/claude-haiku-4.5` | Claude Haiku 4.5 | $1.00/M | $5.00/M | 200K |
 
 :::warning{title="Opus 4.7 / 4.8 behavior"}
@@ -129,9 +145,12 @@ These flagship models reject all sampling parameters (`temperature`, `top_p`, `t
 | Model ID | Name | Input Price | Output Price | Context |
 |----------|------|-------------|--------------|---------|
 | `google/gemini-3.1-pro` | Gemini 3.1 Pro | $2.00/M | $12.00/M | 1M |
-| `google/gemini-3.5-flash` | Gemini 3.5 Flash | $1.50/M | $9.00/M | 1M |
 | `google/gemini-2.5-pro` | Gemini 2.5 Pro | $1.25/M | $10.00/M | 1M |
+| `google/gemini-3.5-flash` | Gemini 3.5 Flash | $1.50/M | $9.00/M | 1M |
+| `google/gemini-3.6-flash` | Gemini 3.6 Flash | $1.50/M | $7.50/M | 1M |
+| `google/gemini-3-flash-preview` | Gemini 3 Flash Preview | $0.50/M | $3.00/M | 1M |
 | `google/gemini-2.5-flash` | Gemini 2.5 Flash | $0.30/M | $2.50/M | 1M |
+| `google/gemini-3.5-flash-lite` | Gemini 3.5 Flash Lite | $0.30/M | $2.50/M | 1M |
 | `google/gemini-3.1-flash-lite` | Gemini 3.1 Flash Lite | $0.25/M | $1.50/M | 1M |
 | `google/gemini-2.5-flash-lite` | Gemini 2.5 Flash Lite | $0.10/M | $0.40/M | 1M |
 
@@ -143,61 +162,83 @@ Gemini **Pro** models (`gemini-2.5-pro`, `gemini-3.1-pro`) bill a **long-context
 |----------|------|-------------|--------------|---------|
 | `xai/grok-4.5` | Grok 4.5 | $2.50/M | $9.00/M | 500K |
 | `xai/grok-4.3` | Grok 4.3 | $1.50/M | $4.00/M | 1M |
-| `xai/grok-build-0.1` | Grok Build 0.1 | $1.50/M | $3.00/M | 256K |
+| `xai/grok-build-0.1` | Grok Build 0.1 | $1.50/M | $3.00/M | 250K |
 
 Grok bills a **long-context tier** at 2x the rates above once a request's prompt reaches 200K tokens (mirrors xAI's official pricing — e.g. Grok 4.5 is $5.00/M in · $18.00/M out above the threshold). Live Search adds $0.025 per source used. Grok Imagine image/video SKUs are listed under Image / Video Generation below.
 
 ### DeepSeek
 
 | Model ID | Name | Input Price | Output Price | Context |
 |----------|------|-------------|--------------|---------|
-| `deepseek/deepseek-chat` | DeepSeek V4 Flash Chat | $0.14/M | $0.28/M | 1M |
 | `deepseek/deepseek-v4-pro` | DeepSeek V4 Pro | $0.435/M | $0.87/M | 1M |
-| `deepseek/deepseek-reasoner` | DeepSeek Reasoner | $0.14/M | $0.28/M | 128K |
+| `deepseek/deepseek-chat` | DeepSeek V4 Flash Chat | $0.14/M | $0.28/M | 1M |
+| `deepseek/deepseek-reasoner` | DeepSeek V4 Flash Reasoner | $0.14/M | $0.28/M | 1M |
 
 ### Z.AI
 
 | Model ID | Name | Input Price | Output Price | Context |
 |----------|------|-------------|--------------|---------|
-| `zai/glm-5.3` | GLM-5.3 (flagship) | $1.40/M | $4.40/M | 1M |
-| `zai/glm-5.3-flash` | GLM-5.3 Flash (multimodal) | $0.15/M | $0.50/M | 1M |
-| `zai/glm-5.2` | GLM-5.2 | $1.40/M | $4.40/M | 1M |
+| `zai/glm-5-code` | GLM-5 Code | $1.20/M | $5.00/M | 200K |
 | `zai/glm-5.1` | GLM-5.1 | $1.40/M | $4.40/M | 200K |
-| `zai/glm-5` | GLM-5 | $1.00/M | $3.20/M | 200K |
+| `zai/glm-5.2` | GLM-5.2 | $1.40/M | $4.40/M | 1M |
+| `zai/glm-5.3` | GLM-5.3 | $1.40/M | $4.40/M | 1M |
 | `zai/glm-5-turbo` | GLM-5 Turbo | $1.20/M | $4.00/M | 200K |
+| `zai/glm-5` | GLM-5 | $1.00/M | $3.20/M | 200K |
+| `zai/glm-5.3-flash` | GLM-5.3 Flash | $0.15/M | $0.50/M | 1M |
 
 ### Moonshot
 
 | Model ID | Name | Input Price | Output Price | Context |
 |----------|------|-------------|--------------|---------|
-| `moonshot/kimi-k3` | Kimi K3 (flagship) | $3.00/M | $15.00/M | 1M |
-| `moonshot/kimi-k2.7` | Kimi K2.7 | $0.95/M | $4.00/M | 256K |
-| `moonshot/kimi-k2.6` | Kimi K2.6 | $0.95/M | $4.00/M | 256K |
-| `moonshot/kimi-k2.5` | Kimi K2.5 (legacy) | $0.60/M | $3.00/M | 262K |
+| `moonshot/kimi-k3` | Kimi K3 | $3.00/M | $15.00/M | 1M |
 
 K3 is the current flagship — a 2.8-trillion-parameter open MoE with a **1M-token context window**, image + text input, returning `reasoning_content` on completions. K2.7 (256K, adds **video** input) remains routable but superseded; K2.6 and K2.5 are earlier multi-modal generations, still routable.
 
 ### MiniMax
 
 | Model ID | Name | Input Price | Output Price | Context |
 |----------|------|-------------|--------------|---------|
+| `minimax/minimax-m2.7` | MiniMax M2.7 | $0.30/M | $1.20/M | 200K |
 | `minimax/minimax-m3` | MiniMax M3 | $0.30/M | $1.20/M | 1M |
 
 ### Qwen (Alibaba)
 
 | Model ID | Name | Input Price | Output Price | Context |
 |----------|------|-------------|--------------|---------|
-| `qwen/qwen3.7-max` | Qwen3.7 Max | $1.48/M | $4.43/M | 1M |
+| `qwen/qwen3.7-max` | Qwen3.7 Max | $1.475/M | $4.425/M | 1M |
+| `qwen/qwen3.7-plus` | Qwen3.7 Plus | $0.32/M | $1.28/M | 1M |
+| `qwen/qwen3.7-flash` | Qwen3.7 Flash | $0.03/M | $0.13/M | 1M |
+
+### Tencent
+
+| Model ID | Name | Input Price | Output Price | Context |
+|----------|------|-------------|--------------|---------|
+| `tencent/hy3` | Tencent Hy3 | $0.132/M | $0.528/M | 256K |
+
+### Xiaomi
+
+| Model ID | Name | Input Price | Output Price | Context |
+|----------|------|-------------|--------------|---------|
+| `xiaomi/mimo-v2.5-pro` | Xiaomi MiMo-V2.5 Pro | $0.435/M | $0.87/M | 1M |
+
+### Flat-priced (open-weight)
+
+Open-weight models billed at a flat per-request price instead of per token — the request is the unit, whatever its length.
+
+| Model ID | Name | Price | Context |
+|----------|------|-------|---------|
+| `openai/gpt-oss-120b` | GPT-OSS 120B | $0.002/request | 128K |
+| `openai/gpt-oss-20b` | GPT-OSS 20B | $0.001/request | 128K |
 
 ### Free Tier (open-weight)
 
-Open-weight models served free of charge (no x402 payment), subject to a small per-IP rate limit. The free tier auto-routes around any temporarily unavailable model, so the live set is best read from `GET /api/v1/models` (filter on `billingMode: "free"`). There are **5** free models listed on mainnet; the free tier's fallback workhorse is `nvidia/gpt-oss-120b`.
+Open-weight models served free of charge (no x402 payment), subject to a small per-IP rate limit. The free tier auto-routes around any temporarily unavailable model, so the live set is best read from `GET /api/v1/models` (filter on `billing_mode: "free"`). There are **5** free models listed on mainnet.
 
 | Model ID | Name | Input Price | Output Price |
 |----------|------|-------------|--------------|
-| `nvidia/mistral-nemotron` | Mistral Nemotron | **FREE** | **FREE** |
-| `nvidia/step-3.7-flash` | Step 3.7 Flash | **FREE** | **FREE** |
 | `nvidia/nemotron-3-nano-omni-30b-a3b-reasoning` | Nemotron 3 Nano Omni | **FREE** | **FREE** |
+| `nvidia/mistral-nemotron` | Mistral Nemotron | **FREE** | **FREE** |
+| `nvidia/step-3.7-flash` | StepFun Step 3.7 Flash | **FREE** | **FREE** |
 | `nvidia/nemotron-nano-9b-v2` | Nemotron Nano 9B v2 | **FREE** | **FREE** |
 | `nvidia/nemotron-nano-12b-v2-vl` | Nemotron Nano 12B v2 VL | **FREE** | **FREE** |
 
@@ -252,7 +293,7 @@ Prices are per 1 million tokens. Your actual cost depends on:
 
 1. **Input tokens** - Length of your prompt and context
 2. **Output tokens** - Length of the model's response
-3. **Platform fee** - 5% added to provider rates
+3. **Transaction fee** - a flat $0.001 per request; chat tokens carry no platform margin (media and Live Search carry 5%)
 
 The SDK calculates the exact price before each request.
 

diff --git a/docs/frameworks/elizaos.md b/docs/frameworks/elizaos.md
@@ -61,9 +61,9 @@ All BlockRun models are available:
 |----------|--------|
 | OpenAI | gpt-5.4, gpt-5.2, o1, o1-mini |
 | Anthropic | claude-fable-5, claude-opus-5, claude-opus-4.8, claude-sonnet-5, claude-sonnet-4.6, claude-haiku-4.5 |
-| Google | gemini-3.1-pro-preview, gemini-3-flash-preview, gemini-2.5-flash-lite |
+| Google | gemini-3.1-pro, gemini-3-flash-preview, gemini-2.5-flash-lite |
 | DeepSeek | deepseek-chat, deepseek-reasoner |
-| xAI | grok-4-fast |
+| xAI | grok-4.3, grok-4.5 |
 | Meta | llama-3.3-70b, llama-3.1-405b |
 
 See [Models Reference](../api-reference/models.md) for full list.

diff --git a/docs/getting-started/agent-developers.md b/docs/getting-started/agent-developers.md
@@ -179,11 +179,11 @@ results = asyncio.run(process_batch(my_items))
 ### Cost-Optimized
 - `google/gemini-2.5-flash-lite` — Best value ($0.10/$0.40 per 1M)
 - `deepseek/deepseek-chat` — Great value ($0.14/$0.28 per 1M)
-- `nvidia/gpt-oss-120b` — Free (NVIDIA-hosted)
+- `nvidia/step-3.7-flash` — Free (open-weight)
 
 ### Quality-Optimized
 - `openai/gpt-5.4` — Best all-around
-- `anthropic/claude-opus-4.6` — Best for nuanced tasks
+- `anthropic/claude-opus-5` — Best for nuanced tasks
 
 ### Reasoning
 - `openai/o3` — Advanced reasoning

diff --git a/docs/getting-started/sdk-developers.md b/docs/getting-started/sdk-developers.md
@@ -157,7 +157,7 @@ client.chat("openai/gpt-5.2", prompt)
 client.chat("openai/o1", prompt)
 
 # Anthropic
-client.chat("anthropic/claude-opus-4.6", prompt)
+client.chat("anthropic/claude-opus-5", prompt)
 client.chat("anthropic/claude-sonnet-4.6", prompt)
 
 # Google
@@ -178,11 +178,11 @@ client.chat("moonshot/kimi-k3", prompt)
 | Use Case | Recommended Model |
 |----------|-------------------|
 | General purpose | `openai/gpt-5.4` |
-| Cheapest | `google/gemini-2.5-flash-lite` or `nvidia/qwen3-next-80b-a3b-instruct` (free) |
+| Cheapest | `google/gemini-2.5-flash-lite` or `nvidia/step-3.7-flash` (free) |
 | Fastest | `google/gemini-3-flash-preview` |
 | Best reasoning | `openai/o3` |
 | Best for code | `openai/gpt-5.3-codex` or `anthropic/claude-sonnet-4.6` |
-| Best quality | `anthropic/claude-opus-4.6` |
+| Best quality | `anthropic/claude-opus-5` |
 
 ## Error Handling
 

diff --git a/docs/sdks/go.md b/docs/sdks/go.md
@@ -147,19 +147,19 @@ client.Chat("openai/gpt-5.5", prompt)
 client.Chat("openai/o1", prompt)
 
 // Anthropic
-client.Chat("anthropic/claude-opus-4.6", prompt)
+client.Chat("anthropic/claude-opus-5", prompt)
 client.Chat("anthropic/claude-sonnet-4.6", prompt)
 
 // Google
-client.Chat("google/gemini-3.1-pro-preview", prompt)
+client.Chat("google/gemini-3.1-pro", prompt)
 client.Chat("google/gemini-3-flash-preview", prompt)
 client.Chat("google/gemini-2.5-flash-lite", prompt)
 
 // DeepSeek
 client.Chat("deepseek/deepseek-chat", prompt)
 
 // xAI
-client.Chat("xai/grok-4-fast", prompt)
+client.Chat("xai/grok-4.3", prompt)
 ```
 
 ## Concurrent Requests

diff --git a/docs/sdks/typescript.md b/docs/sdks/typescript.md
@@ -175,7 +175,7 @@ const result2 = await client.smartChat('Summarize this article: ...', {
 const result3 = await client.smartChat('Review this contract for legal issues...', {
   routingProfile: 'premium'
 });
-console.log(result3.model);  // "anthropic/claude-opus-4.6"
+console.log(result3.model);  // "anthropic/claude-opus-5"
 ```
 
 ### 4-Tier Model Selection

diff --git a/docs/sdks/xrpl.md b/docs/sdks/xrpl.md
@@ -174,7 +174,7 @@ result = client.smart_chat(
     "Explain recursion",
     routing_profile="free"
 )
-print(result.model)  # "nvidia/gpt-oss-120b"
+print(result.model)  # "openai/gpt-oss-120b"
 
 # Maximum savings mode
 result = client.smart_chat(
@@ -376,7 +376,7 @@ All models from BlockRun Intelligence are available:
 |----------|--------|
 | **OpenAI** | gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna, gpt-5.5, gpt-5.4, gpt-5.4-pro, gpt-5.3, gpt-5.2, gpt-5.4-mini, gpt-5-mini, gpt-5.4-nano, o1, o1-mini, o3, o3-mini |
 | **Anthropic** | claude-fable-5, claude-opus-5, claude-opus-4.8, claude-opus-4.7, claude-sonnet-5, claude-sonnet-4.6, claude-haiku-4.5 |
-| **Google** | gemini-3.1-pro-preview, gemini-3-flash-preview, gemini-2.5-pro, gemini-2.5-flash, gemini-2.5-flash-lite |
+| **Google** | gemini-3.1-pro, gemini-3-flash-preview, gemini-2.5-pro, gemini-2.5-flash, gemini-2.5-flash-lite |
 | **xAI** | grok-4.1, grok-4, grok-3, grok-3-fast |
 | **DeepSeek** | deepseek-chat, deepseek-reasoner |
 | **NVIDIA** | gpt-oss-120b (FREE), step-3.7-flash (FREE) |