From 01a6c707a32f427c3c2b07cce07e6d863d87715f Mon Sep 17 00:00:00 2001
From: Chesars <cesarponce19544@gmail.com>
Date: Wed, 11 Mar 2026 13:34:56 -0300
Subject: [PATCH] docs: restore gpt-5.4 reasoning_effort tip lost during rebase

---
 docs/my-website/docs/providers/openai.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/docs/my-website/docs/providers/openai.md b/docs/my-website/docs/providers/openai.md
index adddc3efc4a..576a0dcb8ff 100644
--- a/docs/my-website/docs/providers/openai.md
+++ b/docs/my-website/docs/providers/openai.md
@@ -689,6 +689,21 @@ response = litellm.completion(
 
 ### Examples
 
+:::tip gpt-5.4 + reasoning_effort + function tools
+
+OpenAI does not support `reasoning_effort` with function tools for `gpt-5.4` in `/v1/chat/completions`. Use the responses bridge instead:
+
+```python
+response = litellm.completion(
+    model="openai/responses/gpt-5.4",  # routes to /v1/responses
+    messages=[{"role": "user", "content": "What's the weather?"}],
+    tools=[...],
+    reasoning_effort="low",
+)
+```
+
+:::
+
 <Tabs>
 <TabItem value="sdk" label="SDK">