diff --git a/api-reference/inference-api/images/create-image-edit.mdx b/api-reference/inference-api/images/create-image-edit.mdx
index af9f0996..1638736f 100644
--- a/api-reference/inference-api/images/create-image-edit.mdx
+++ b/api-reference/inference-api/images/create-image-edit.mdx
@@ -2,3 +2,7 @@
 title: Create Image Edit
 openapi: post /images/edits
 ---
+
+<Note>
+Image edit requests use `multipart/form-data` and the provider-prefixed model aliases inside multipart payloads is not supported, so pass the upstream provider's model or deployment name directly in the `model` form field instead of values like `@provider/model-name`.
+</Note>
diff --git a/product/ai-gateway/multimodal-capabilities/image-generation.mdx b/product/ai-gateway/multimodal-capabilities/image-generation.mdx
index 896c1a54..1c58fc60 100644
--- a/product/ai-gateway/multimodal-capabilities/image-generation.mdx
+++ b/product/ai-gateway/multimodal-capabilities/image-generation.mdx
@@ -125,9 +125,14 @@ curl "https://api.portkey.ai/v1/images/generations" \
   </Tab>
 </Tabs>
 
+<Note>
+For Image Edit requests, provider-prefixed model aliases inside multipart payloads are not supported. The `model` value should match the model or deployment name expected by the upstream provider.
+</Note>
+
 ### API Reference
 
-[Create Image](/provider-endpoints/images/create-image)
+- [Create Image](/provider-endpoints/images/create-image)
+- [Create Image Edit](/provider-endpoints/images/create-image-edit)
 
 ### OpenAI gpt-image-1 Parameters