diff --git a/docs/api-reference/models.md b/docs/api-reference/models.md
index ac76c74..7da6c1c 100644
--- a/docs/api-reference/models.md
+++ b/docs/api-reference/models.md
@@ -221,9 +221,9 @@ Grok bills a **long-context tier** at 2x the rates above once a request's prompt
 
 | Model ID | Name | Input Price | Output Price | Context |
 |----------|------|-------------|--------------|---------|
-| `moonshot/kimi-k3` | Kimi K3 | $3.00/M | $15.00/M | 1M |
+| `moonshot/kimi-k3.1-pro` | Kimi K3.1 Pro | $2.00/M | $10.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.
+K3.1 Pro is the current flagship — Moonshot's post-trained successor to K3, built for long-horizon coding and agents, with a **1M-token context window**, image + text input, and `reasoning_content` on completions. Cached input is $0.20/M. K3 ($3.00/$15.00) remains routable but superseded. K2.7 (256K, adds **video** input) remains routable but superseded; K2.6 and K2.5 are earlier multi-modal generations, still routable.
 
 ### MiniMax
 
diff --git a/docs/getting-started/sdk-developers.md b/docs/getting-started/sdk-developers.md
index 0eb409e..8c6232d 100644
--- a/docs/getting-started/sdk-developers.md
+++ b/docs/getting-started/sdk-developers.md
@@ -198,7 +198,7 @@ client.chat("deepseek/deepseek-chat", prompt)
 client.chat("deepseek/deepseek-reasoner", prompt)
 
 # Moonshot
-client.chat("moonshot/kimi-k3", prompt)
+client.chat("moonshot/kimi-k3.1-pro", prompt)
 ```
 
 ### Model Selection Tips
diff --git a/docs/resources/changelog.md b/docs/resources/changelog.md
index 56da44a..70156f1 100644
--- a/docs/resources/changelog.md
+++ b/docs/resources/changelog.md
@@ -7,6 +7,13 @@ description: All notable changes to BlockRun — gateway endpoints, model lineup
 
 All notable changes to BlockRun, newest first — gateway endpoints, model lineup, pricing, and SDK releases.
 
+## [2026-10-25]
+
+### Added — Kimi K3.1 Pro
+- **`moonshot/kimi-k3.1-pro`** ($2.00/M in · $10.00/M out, $0.20/M cached, **1M context**, image + text input, returns `reasoning_content`) — Moonshot's post-trained successor to Kimi K3, built for long-horizon coding and agents. Cheaper than K3's $3.00/$15.00. Verified live with real completions, streaming, forced and automatic tool calls, and vision before listing.
+- Kimi K3.1 Pro replaces K3 as the featured Kimi. `moonshot/kimi-k3` is hidden from the public list but stays routable; with `allow_fallback` on, a failed K3 call is retried on K3.1 Pro.
+- Visible model counts are unchanged.
+
 ## [2026-10-10]
 
 ### Changed — GPT-6 calls are priced by reasoning effort