> ## Documentation Index
> Fetch the complete documentation index at: https://developers.jasper.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Uncrop

Extends the image in the specified directions and generates plausible content to fill the new areas.

<Callout icon="📘" theme="info">
  ## Get Started with Image API

  To use Jasper's Image endpoints, you'll need an API key. Image API access is available for customers on the Jasper Business plan with an API subscription.

  **Already a Business customer?** Generate your API key in <Anchor label="Settings → API Tokens" target="_blank" href="https://app.jasper.ai/settings/dev-tools/tokens">Settings → API Tokens</Anchor>.

  **New to Jasper?** [Request API access →](https://developers.jasper.ai/docs/request-image-api-access)
</Callout>

<a label="LLM friendly version" href="https://developers.jasper.ai/reference/uncrop.md">LLM friendly version</a>

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "paths": {
    "/v1/image/uncrop": {
      "post": {
        "description": "Extends the image in the specified directions and generates plausible content to fill the new areas.",
        "operationId": "uncrop",
        "parameters": [
          {
            "name": "accept",
            "required": false,
            "in": "header",
            "description": "The Accept request HTTP header indicates the preferred returned image content type, expressed as a MIME type",
            "schema": {
              "type": "string",
              "enum": [
                "image/webp",
                "image/png",
                "image/jpeg"
              ]
            }
          }
        ],
        "requestBody": {
          "required": true,
          "description": "The request must be an http POST and its body must be a multipart/form-data that has one image file & several text fields",
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "image_file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The original image to process should be a JPG, PNG or WebP, with a maximum resolution of 10 megapixels and a max file size of 30 Mb."
                  },
                  "extend_left": {
                    "type": "number",
                    "description": "Number of pixels to extend to the left",
                    "maximum": 2000
                  },
                  "extend_right": {
                    "type": "number",
                    "description": "Number of pixels to extend to the right",
                    "maximum": 2000
                  },
                  "extend_up": {
                    "type": "number",
                    "description": "Number of pixels to extend upward",
                    "maximum": 2000
                  },
                  "extend_down": {
                    "type": "number",
                    "description": "Number of pixels to extend downward",
                    "maximum": 2000
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The image was successfully uncropped."
          },
          "400": {
            "description": "Bad request. May be missing required inputs or may have badly formatted inputs or options."
          },
          "500": {
            "description": "Internal server error. Unable to uncrop image."
          }
        },
        "security": [
          {
            "X-API-Key": []
          },
          {
            "oauth2": [
              "user"
            ]
          }
        ],
        "summary": "Uncrop",
        "tags": [
          "Images"
        ]
      }
    }
  },
  "info": {
    "title": "Jasper API",
    "description": "Jasper API",
    "version": "1.0",
    "contact": {}
  },
  "servers": [
    {
      "url": "https://api.jasper.ai"
    }
  ],
  "components": {
    "securitySchemes": {
      "X-API-Key": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key",
        "description": "Workspace authentication using API key tokens in the X-API-Key header."
      },
      "oauth2": {
        "type": "oauth2",
        "flows": {
          "authorizationCode": {
            "authorizationUrl": "https://api.jasper.ai/oauth2/authorize",
            "tokenUrl": "https://api.jasper.ai/oauth2/token",
            "refreshUrl": "https://api.jasper.ai/oauth2/token",
            "scopes": {
              "user:read": "Read user information",
              "user": "Read and write user information"
            }
          }
        },
        "description": "User-level authentication using OAuth bearer tokens in the Authorization header."
      }
    }
  },
  "x-readme": {
    "metrics-enabled": false
  }
}
```