diff --git a/README.md b/README.md
index 8d3df75..86dfc77 100644
--- a/README.md
+++ b/README.md
@@ -32,10 +32,13 @@ echo $response->text;
 ## Available Models
 
 ```php
-DeepSeekProvider::MODEL_DEEPSEEK_CHAT      // 'deepseek-chat' (default)
-DeepSeekProvider::MODEL_DEEPSEEK_REASONER  // 'deepseek-reasoner' (reasoning)
+DeepSeekProvider::MODEL_DEEPSEEK_V4_FLASH  // 'deepseek-v4-flash' (default)
+DeepSeekProvider::MODEL_DEEPSEEK_V4_PRO    // 'deepseek-v4-pro'
 ```
 
+The `MODEL_DEEPSEEK_CHAT` and `MODEL_DEEPSEEK_REASONER` constants are still shipped but deprecated: both were discontinued on 24 July 2026 and requests using them fail. The V4 family replaces the old chat and reasoner split, with the neutral `effort` option controlling how hard the model thinks.
+
+
 ## Features
 
 - Tool/function calling
diff --git a/docs/provider.md b/docs/provider.md
index eac9899..631eb8f 100644
--- a/docs/provider.md
+++ b/docs/provider.md
@@ -30,10 +30,13 @@ echo $response->text;
 ## Models
 
 ```php
-DeepSeekProvider::MODEL_DEEPSEEK_CHAT      // 'deepseek-chat' (default)
-DeepSeekProvider::MODEL_DEEPSEEK_REASONER  // 'deepseek-reasoner' (reasoning)
+DeepSeekProvider::MODEL_DEEPSEEK_V4_FLASH  // 'deepseek-v4-flash' (default)
+DeepSeekProvider::MODEL_DEEPSEEK_V4_PRO    // 'deepseek-v4-pro'
 ```
 
+The `MODEL_DEEPSEEK_CHAT` and `MODEL_DEEPSEEK_REASONER` constants are still shipped but deprecated: both were discontinued on 24 July 2026 and requests using them fail. The V4 family replaces the old chat and reasoner split, with the neutral `effort` option controlling how hard the model thinks.
+
+
 ## Capabilities
 
 | Capability | Supported |