---
title: Score Image Exposure API
slug: score-image-exposure
url: https://apyhub.com/dosvak/service/score-image-exposure
provider: Dosvak LLC
tags: [image-quality, exposure-analysis, clipping-detection, photo-review, image-processing]
auth: api_key
version: 1.0.0
service_type: sync
endpoints: 1
atoms: 100
---

# Score Image Exposure API

Score a single image file for exposure quality and clipping. Returns numeric exposure metrics and recommendations for automated photo review.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| POST | `https://api.eu.apyhub.com/dosvak/score-image-exposure` | What it does Scores an uploaded image for exposure and clipping by analyzing the submitted file and… | 100 |

## Endpoint reference

### Score image exposure and clipping

`POST https://api.eu.apyhub.com/dosvak/score-image-exposure` · 100 atoms · accepts `multipart/form-data` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `file` | body | string (binary) | yes | Image file |

#### Quickstart

Upload an image to score its exposure.

```bash
curl -X POST "https://api.eu.apyhub.com/dosvak/score-image-exposure" \
  -H "apy-token: $APY_TOKEN" \
  -F "file=@/path/to/image.jpg"
```

#### What you'll get back

Returns a JSON object with numeric exposure metrics and a `recommendations` array of strings.

```json
{
  "score": 82.4,
  "mean_luma": 0.71,
  "shadow_pct": 12.3,
  "contrast_std": 18.6,
  "dynamic_range": 7.9,
  "highlight_pct": 4.1,
  "recommendations": ["Exposure looks balanced"]
}
```

## About

## What it does
Image Exposure Score checks a single image file for exposure quality and clipping. Send a binary image in the `file` field, and get back a numeric `score` plus exposure measurements you can use in automated review or tuning workflows.

The response includes `mean_luma`, `shadow_pct`, `contrast_std`, `dynamic_range`, and `highlight_pct`, along with a `recommendations` array of strings. That makes it easy to compare images consistently, flag underexposed or overexposed assets, and surface a short explanation for editors or QA tools.

Use Image Exposure Score when you need to screen uploaded photos before publishing, reject low-quality user submissions, or route borderline images for manual review. Because the API returns structured metrics rather than a simple pass/fail, you can set your own thresholds for different content types, cameras, or production standards.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/dosvak/service/score-image-exposure