diff --git a/docs/my-website/docs/image_edits.md b/docs/my-website/docs/image_edits.md
new file mode 100644
index 00000000000..bae95fc3bc6
--- /dev/null
+++ b/docs/my-website/docs/image_edits.md
@@ -0,0 +1,232 @@
+import Image from '@theme/IdealImage';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# /images/edits
+
+LiteLLM provides image editing functionality that maps to OpenAI's `/images/edits` API endpoint.
+
+| Feature | Supported | Notes |
+|---------|-----------|--------|
+| Cost Tracking | ✅ | Works with all supported models |
+| Logging | ✅ | Works across all integrations |
+| End-user Tracking | ✅ | |
+| Fallbacks | ✅ | Works between supported models |
+| Loadbalancing | ✅ | Works between supported models |
+| Supported operations | Create image edits | |
+| Supported LiteLLM Versions | 1.63.8+ | |
+| Supported LLM providers | **OpenAI** | Currently only `openai` is supported |
+
+## Usage
+
+### LiteLLM Python SDK
+
+
+
+
+#### Basic Image Edit
+```python showLineNumbers title="OpenAI Image Edit"
+import litellm
+
+# Edit an image with a prompt
+response = litellm.image_edit(
+ model="dall-e-2",
+ image=open("original_image.png", "rb"),
+ prompt="Add a red hat to the person in the image",
+ n=1,
+ size="1024x1024"
+)
+
+print(response)
+```
+
+#### Image Edit with Mask
+```python showLineNumbers title="OpenAI Image Edit with Mask"
+import litellm
+
+# Edit an image with a mask to specify the area to edit
+response = litellm.image_edit(
+ model="dall-e-2",
+ image=open("original_image.png", "rb"),
+ mask=open("mask_image.png", "rb"), # Transparent areas will be edited
+ prompt="Replace the background with a beach scene",
+ n=2,
+ size="512x512",
+ response_format="url"
+)
+
+print(response)
+```
+
+#### Async Image Edit
+```python showLineNumbers title="Async OpenAI Image Edit"
+import litellm
+import asyncio
+
+async def edit_image():
+ response = await litellm.aimage_edit(
+ model="dall-e-2",
+ image=open("original_image.png", "rb"),
+ prompt="Make the image look like a painting",
+ n=1,
+ size="1024x1024",
+ response_format="b64_json"
+ )
+ return response
+
+# Run the async function
+response = asyncio.run(edit_image())
+print(response)
+```
+
+#### Image Edit with Custom Parameters
+```python showLineNumbers title="OpenAI Image Edit with Custom Parameters"
+import litellm
+
+# Edit image with additional parameters
+response = litellm.image_edit(
+ model="dall-e-2",
+ image=open("portrait.png", "rb"),
+ prompt="Add sunglasses and a smile",
+ n=3,
+ size="1024x1024",
+ response_format="url",
+ user="user-123",
+ timeout=60,
+ extra_headers={"Custom-Header": "value"}
+)
+
+print(f"Generated {len(response.data)} image variations")
+for i, image_data in enumerate(response.data):
+ print(f"Image {i+1}: {image_data.url}")
+```
+
+
+
+
+### LiteLLM Proxy with OpenAI SDK
+
+First, set up and start your LiteLLM proxy server.
+
+```bash showLineNumbers title="Start LiteLLM Proxy Server"
+litellm --config /path/to/config.yaml
+
+# RUNNING on http://0.0.0.0:4000
+```
+
+
+
+
+First, add this to your litellm proxy config.yaml:
+```yaml showLineNumbers title="OpenAI Proxy Configuration"
+model_list:
+ - model_name: dall-e-2
+ litellm_params:
+ model: dall-e-2
+ api_key: os.environ/OPENAI_API_KEY
+```
+
+#### Basic Image Edit via Proxy
+```python showLineNumbers title="OpenAI Proxy Image Edit"
+from openai import OpenAI
+
+# Initialize client with your proxy URL
+client = OpenAI(
+ base_url="http://localhost:4000", # Your proxy URL
+ api_key="your-api-key" # Your proxy API key
+)
+
+# Edit an image
+response = client.images.edit(
+ model="dall-e-2",
+ image=open("original_image.png", "rb"),
+ prompt="Add a red hat to the person in the image",
+ n=1,
+ size="1024x1024"
+)
+
+print(response)
+```
+
+#### Image Edit with Mask via Proxy
+```python showLineNumbers title="OpenAI Proxy Image Edit with Mask"
+from openai import OpenAI
+
+# Initialize client with your proxy URL
+client = OpenAI(
+ base_url="http://localhost:4000", # Your proxy URL
+ api_key="your-api-key" # Your proxy API key
+)
+
+# Edit an image with a mask
+response = client.images.edit(
+ model="dall-e-2",
+ image=open("original_image.png", "rb"),
+ mask=open("mask_image.png", "rb"),
+ prompt="Replace the background with a mountain landscape",
+ n=2,
+ size="512x512"
+)
+
+print(response)
+```
+
+#### cURL Example
+```bash showLineNumbers title="cURL Image Edit Request"
+curl -X POST "http://localhost:4000/v1/images/edits" \
+ -H "Authorization: Bearer your-api-key" \
+ -F "model=dall-e-2" \
+ -F "image=@original_image.png" \
+ -F "mask=@mask_image.png" \
+ -F "prompt=Add a beautiful sunset in the background" \
+ -F "n=1" \
+ -F "size=1024x1024" \
+ -F "response_format=url"
+```
+
+
+
+
+## Supported Image Edit Parameters
+
+| Parameter | Type | Description | Required |
+|-----------|------|-------------|----------|
+| `image` | `FileTypes` | The image to edit. Must be a valid PNG file, less than 4MB, and square. | ✅ |
+| `prompt` | `str` | A text description of the desired image edit. | ✅ |
+| `model` | `str` | The model to use for image editing. Currently only `dall-e-2` is supported. | Optional (defaults to `dall-e-2`) |
+| `mask` | `str` | An additional image whose fully transparent areas indicate where the original image should be edited. Must be a valid PNG file, less than 4MB, and have the same dimensions as `image`. | Optional |
+| `n` | `int` | The number of images to generate. Must be between 1 and 10. | Optional (defaults to 1) |
+| `size` | `str` | The size of the generated images. Must be one of `256x256`, `512x512`, or `1024x1024`. | Optional (defaults to `1024x1024`) |
+| `response_format` | `str` | The format in which the generated images are returned. Must be one of `url` or `b64_json`. | Optional (defaults to `url`) |
+| `user` | `str` | A unique identifier representing your end-user. | Optional |
+
+
+## Response Format
+
+The response follows the OpenAI Images API format:
+
+```python showLineNumbers title="Image Edit Response Structure"
+{
+ "created": 1677649800,
+ "data": [
+ {
+ "url": "https://example.com/edited_image_1.png"
+ },
+ {
+ "url": "https://example.com/edited_image_2.png"
+ }
+ ]
+}
+```
+
+For `b64_json` format:
+```python showLineNumbers title="Base64 Response Structure"
+{
+ "created": 1677649800,
+ "data": [
+ {
+ "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."
+ }
+ ]
+}
+```
diff --git a/docs/my-website/sidebars.js b/docs/my-website/sidebars.js
index bbf1906ff2d..89020a7f3bd 100644
--- a/docs/my-website/sidebars.js
+++ b/docs/my-website/sidebars.js
@@ -217,6 +217,7 @@ const sidebars = {
label: "/images",
items: [
"image_generation",
+ "image_edits",
"image_variations",
]
},