Overview

Hirak FaceAPI provides face detection and recognition capabilities including age estimation and gender classification from images. It can detect multiple faces in a single image and return structured data about each one. The API has no hard quota limits, making it suitable for testing and small-scale projects.

Beginner Tip

Send images as publicly accessible URLs rather than base64 when starting out—it is simpler and avoids payload size issues. Make sure the image URL is reachable and not behind any authentication or firewall.

Available Data

The kind of data this API exposes, based on its documentation. We could not call the endpoint to confirm the exact field names.

prediction result with confidence score
input name or text
statistical data

Example Response

Illustrative shape only — we were not able to call this endpoint (it requires credentials or exposes no public sample URL), so the fields below show the kind of data this API returns rather than a recorded response.

JSON Response · Illustrative
{
  "status": "success",
  "data": {
    "result": "Data from Hirak FaceAPI",
    "description": "Face detection, face recognition with age estimation/gender estimation, accurate, no quota limits",
    "timestamp": "2025-01-15T10:00:00Z"
  }
}

Field Reference

faces Array of detected face objects, one per face found in the image.
faces[].age Estimated age of the detected person in years.
faces[].gender Predicted gender of the detected person (e.g., 'male' or 'female').
faces[].confidence Confidence score from 0 to 1 for the face detection result.
count Total number of faces detected in the submitted image.

Implementation Example

Calls a real endpoint of this API. Replace any placeholder credentials with your own key.

Request
const url = "https://faceapi.hirak.site/api/face?api_key=YOUR_API_KEY&url=https://upload.wikimedia.org/wikipedia/commons/thumb/1/14/Gatto_europeo4.jpg/320px-Gatto_europeo4.jpg";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "X-API-Key": "YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

Generated guidance based on this API's documentation, not observed by us. Treat it as a starting point and check against the provider's own error reference.

401 Unauthorized or invalid key API key is missing or incorrect in the request
Double-check your API key from the Hirak FaceAPI dashboard and pass it as the api_key query parameter.
No face detected The image does not contain a clearly visible human face, or the image quality is too low
Use a clear, well-lit frontal face photo with a resolution of at least 200x200 pixels for best detection results.
Image URL not accessible The image URL is private, expired, or returns a non-image content type
Ensure the image URL is publicly reachable by testing it in a browser and that it directly serves an image file such as jpg or png.

Metadata Score Breakdown

Estimated from metadata — endpoint not independently tested

This score is estimated from observable metadata — HTTPS support, authentication model, declared CORS, and documentation reachability — because the API requires authentication or exposes no publicly testable endpoint. The five-signal breakdown is only shown for live-tested APIs.

Metadata estimate · endpoint not independently tested

Technical Specifications

Auth API Key
HTTPS REQUIRED
CORS UNKNOWN
Category Machine Learning
Difficulty Intermediate
Listing details not endpoint-verified

Related Tags

Similar APIs

View All →