# Analyze

Analyzes the image and answers the provided question with a short, focused response.

<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/analyse.md">LLM friendly version</a>

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "paths": {
    "/v1/image/analysis": {
      "post": {
        "description": "Analyzes the image and answers the provided question with a short, focused response.",
        "operationId": "analyse",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ImageAnalysisRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The analysis was successfully generated.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ImageAnalysisResponseDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad request. May be missing required inputs or may have badly formatted inputs or options."
          },
          "500": {
            "description": "Internal server error. Unable to remove background."
          }
        },
        "security": [
          {
            "X-API-Key": []
          },
          {
            "oauth2": [
              "user"
            ]
          }
        ],
        "summary": "Analyze",
        "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."
      }
    },
    "schemas": {
      "ImageAnalysisRequestDto": {
        "type": "object",
        "properties": {
          "imageUrl": {
            "type": "string",
            "description": "The URL of the image to check.",
            "example": "https://example.com/image.png"
          },
          "question": {
            "type": "string",
            "description": "The expected analysis to perform on the image.",
            "example": "Is the main object centered and fully visible?"
          }
        },
        "required": [
          "imageUrl",
          "question"
        ]
      },
      "ImageAnalysisResponseDto": {
        "type": "object",
        "properties": {
          "analysis": {
            "type": "string",
            "description": "The result of the analysis of the image.",
            "example": "Yes the main object is centered and fully visible."
          }
        },
        "required": [
          "analysis"
        ]
      }
    }
  },
  "x-readme": {
    "metrics-enabled": false
  }
}
```