diff --git a/swagger/docs.go b/swagger/docs.go
index aa0d16d3e..94861edbf 100644
--- a/swagger/docs.go
+++ b/swagger/docs.go
@@ -3756,9 +3756,10 @@ const docTemplate = `{
                     },
                     {
                         "type": "integer",
-                        "description": "Upscale factor: 2 or 4 (default 2)",
+                        "description": "Upscale factor: integer from 1 to 16; must match the model native scale",
                         "name": "scale",
-                        "in": "formData"
+                        "in": "formData",
+                        "required": true
                     }
                 ],
                 "responses": {
@@ -7242,6 +7243,9 @@ const docTemplate = `{
                     "items": {
                         "$ref": "#/definitions/schema.ThreeDOperation"
                     }
+                },
+                "upscale_scale": {
+                    "type": "integer"
                 }
             }
         },
diff --git a/swagger/swagger.json b/swagger/swagger.json
index 89bc82bf9..95a87d2c3 100644
--- a/swagger/swagger.json
+++ b/swagger/swagger.json
@@ -3753,9 +3753,10 @@
                     },
                     {
                         "type": "integer",
-                        "description": "Upscale factor: 2 or 4 (default 2)",
+                        "description": "Upscale factor: integer from 1 to 16; must match the model native scale",
                         "name": "scale",
-                        "in": "formData"
+                        "in": "formData",
+                        "required": true
                     }
                 ],
                 "responses": {
@@ -7239,6 +7240,9 @@
                     "items": {
                         "$ref": "#/definitions/schema.ThreeDOperation"
                     }
+                },
+                "upscale_scale": {
+                    "type": "integer"
                 }
             }
         },
diff --git a/swagger/swagger.yaml b/swagger/swagger.yaml
index 296c61ba0..2d1703773 100644
--- a/swagger/swagger.yaml
+++ b/swagger/swagger.yaml
@@ -1947,6 +1947,8 @@ definitions:
         items:
           $ref: '#/definitions/schema.ThreeDOperation'
         type: array
+      upscale_scale:
+        type: integer
     type: object
   schema.ModelCapabilitiesResponse:
     properties:
@@ -6203,9 +6205,11 @@ paths:
         name: image
         required: true
         type: file
-      - description: 'Upscale factor: 2 or 4 (default 2)'
+      - description: 'Upscale factor: integer from 1 to 16; must match the model native
+          scale'
         in: formData
         name: scale
+        required: true
         type: integer
       produces:
       - application/json