POST/api/v1/images/score

Score Image

Analyze a portrait photo and receive a quality score, brightness and sharpness measurements, and actionable tips for improvement.

Prompt for Vibe Coder

Skip the docs — paste this prompt into your AI agent and let it handle the integration.

Base URL

https://api.runflow.io

Authentication

Include your API key in the request header:

Header	Type	Required	Description
`x-api-key`	string	Yes	Your Runflow API key

Request Body

You can send the image in one of two ways:

Option 1File Uploadmultipart/form-data

Field	Type	Description
`image`	File	The image file to analyze (JPEG, PNG, WebP)

Option 2JSON Bodyapplication/json

Field	Type	Description
`image_url`	string	Public URL of the image to analyze

Examples

bash

curl -X POST https://api.runflow.io/api/v1/images/score \
  -H "x-api-key: YOUR_API_KEY" \
  -F "image=@/path/to/photo.jpg"

Response

Returns a JSON object with the image analysis results:

json

{
  "quality_score": 0.8,
  "tips": [
    "Try to look straight at the camera."
  ],
  "brightness": 83.07600402832031,
  "sharpness": 96.61495208740234
}

Field	Type	Description
`quality_score`	number	Overall quality score from 0.0 to 1.0
`tips`	string[]	Actionable suggestions to improve the photo
`brightness`	number	Brightness measurement (0–100 scale)
`sharpness`	number	Sharpness measurement (0–100 scale)