apyhub
Back
▣ ARTIFICIAL INTELLIGENCE · IMAGE PROCESSING

Score Image Quality API

What it does

Image Quality Scorer analyzes an uploaded image and returns a composition and visual-quality breakdown. Send a binary image file up to 20 MB, and get back an overall score plus component metrics that help you understand what is driving the result.

The response includes face_count, color_score, thirds_score, exposure_score, sharpness_score, and a suggestions array of strings. That makes it useful when you need to rank user-submitted photos, filter low-quality images before moderation or review, or give photographers and creators quick feedback on framing, lighting, and focus.

Use it anywhere image quality matters but a human review would be too slow or inconsistent. For example, you can sort marketplace listings by image quality, reject blurry uploads before they hit storage, or score candidate thumbnails before choosing the best one for a campaign.

Image Quality Scorer returns simple numeric signals you can compare, threshold, or combine with your own business rules.

POST
Score image composition and visual quality
https://api.eu.apyhub.com/dosvak/score-image-aesthetic-quality

QUICKSTART

GUIDE

Quickstart

Upload an image to score its aesthetic quality.

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

What you'll get back

Returns a JSON object with numeric scoring fields such as score, face_count, color_score, thirds_score, exposure_score, and sharpness_score, plus suggestions as an array of strings.

{
  "score": 0.82,
  "face_count": 1,
  "color_score": 0.77,
  "suggestions": ["Improve lighting", "Try a tighter crop"],
  "thirds_score": 0.74,
  "exposure_score": 0.8,
  "sharpness_score": 0.79
}
TRY ITLIVE · 100 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.
body*
Image file

About this endpoint

What it does

Scores an uploaded image for composition and visual quality. It accepts one image file in the request body and returns numeric quality metrics, a face count, and a list of improvement suggestions.

Request Body

ParameterTypeDescription
fileBinaryImage file uploaded as binary. Maximum size: 20 MB.

Response

Returns a JSON object with score (number), face_count (integer), color_score (number), suggestions (string array), thirds_score (number), exposure_score (number), and sharpness_score (number) fields.

ParameterTypeDescription
scoreNumberOverall image score.
face_countIntegerNumber of faces detected in the image.
color_scoreNumberColor-related score.
suggestionsString ArrayList of suggestion strings.
thirds_scoreNumberScore related to composition using the rule of thirds.
exposure_scoreNumberExposure-related score.
sharpness_scoreNumberSharpness-related score.

Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.

Similar APIs

Closest matches in the catalog based on this service.

CALLScore Image Exposure APIDosvak LLCCALLDetect Image Blur APIDosvak LLCCALLClassify NSFW Image APIDosvak LLCCALLAI-Generated Image Detection APIAnyImageDetector

From the blog

Reads that touch this API.

Exploring the Top Video Thumbnail ( Preview) APIsJul 9, 2026What is the Readability Score? Meaning and Use CasesJul 9, 2026Video Thumbnails for SEO: How They Lift CTR, and How to Generate Them with an APISep 22, 2026Top Image Editing APIs for 2026Sep 18, 2026