Skip to main content
POST
/
api
/
v1
/
images
/
score
curl -X POST https://api.runflow.io/api/v1/images/score \ -H "x-api-key: YOUR_API_KEY" \ -F "image=@/path/to/photo.jpg" 
{
  "quality_score": 0.8,
  "tips": [
    "Try to look straight at the camera."
  ],
  "brightness": 83.07600402832031,
  "sharpness": 96.61495208740234
}

Authorizations

​
x-api-key
string
header
required

Your Runflow API key. Include it in the x-api-key header on every request. Keys are issued per customer — contact the founders to get one.

Body

​
image
file
required

The portrait image file to analyze (JPEG, PNG, or WebP).

Response

Image analyzed successfully.

​
quality_score
number<float>
required

Overall quality score from 0.0 to 1.0.

Required range: 0 <= x <= 1
Example:

0.8

​
tips
string[]
required

Actionable suggestions for improving the photo.

Example:
["Try to look straight at the camera."]
​
brightness
number<float>
required

Brightness measurement on a 0–100 scale.

Example:

83.07600402832031

​
sharpness
number<float>
required

Sharpness measurement on a 0–100 scale.

Example:

96.61495208740234