POST /age
Age estimation
Estimate the apparent age of the primary face and optionally return its boundary box or a base64-encoded face crop.
Default response:
age and boundary_box
AGE & FACE ANALYSIS API
Use our age prediction for your projects
Add fast, accurate age estimation and detailed face geometry to your product through a clear JSON API, with competitive pricing tailored to your usage.
Versioned JSON responses
Base64 or image URL input
478 face landmarks
Choose the analysis your product needs
Use age estimation, face mesh analysis, or request both from one image and one combined response.
POST /facemesh
Face mesh
Return 478 three-dimensional facial keypoints, with optional frontalized landmarks and head-pose measurements.
Optional outputs:
frontalized_keypoints and pose
POST /age
Age + face mesh
Run both models on the same preprocessed image and receive age data together with the requested face mesh outputs.
Set
return_facemesh: true in the age requestBuilt for useful, predictable integration
The public API wraps the same age-prediction capability used by our web experience and adds a consistent contract for product teams.
Simple image input
Send raw base64, a data URI, or a public HTTP(S) image URL in a JSON request.
Efficient preprocessing
Large images are resized once to a 1000 px maximum side, then shared across combined analysis.
Flexible response data
Request only the boundary box, crop, landmarks, frontalized points, or pose data your workflow uses.
Consistent error model
Versioned responses and stable error codes make validation and failure handling easier to implement.
From image to structured data
A compact request flow keeps integration straightforward.
Provide one image source
Send either face_image or face_image_url—never both in the same request.
Select the outputs
Use boolean parameters to keep the response focused on the age or face data your application needs.
Handle one JSON contract
Read api_version with the requested result, or a structured error code and message.
Image safeguards are built in
Images can be up to 15 MB, with no side over 4500 px. Images above 1000 px on their longest side are downscaled with their aspect ratio preserved.
Tell us what you are building
Contact us to discuss current pricing, expected request volume, and the response data your product needs.
API questions
Short answers to the most common integration questions.
The API estimates the age of the primary face detected in the supplied image. If no face can be detected, it returns a structured
NO_FACE_DETECTED error.Yes. Send a request to
POST /age with return_facemesh set to true. The age and face mesh models then use the same preprocessed image.Send an image as base64—optionally with a data-URI prefix—or provide a public HTTP(S) URL that the service can fetch.
Pricing is discussed based on your expected usage and integration needs. Contact sales with a short description of your project.