Our API provides secure access to MambaPanel's Professional Face Recognition engine, allowing you to search through our database of 1.8B faces. Each request deducts 1 credit from your account balance.
To use the Face Recognition API, you'll need:
POST https://mambapanel.com/api/v1/face
All requests must include your API key in the Authorization header using Bearer authentication.
Content-Type: application/json
Authorization: Bearer {your_api_key}
| Parameter | Type | Required | Description |
|---|---|---|---|
| image | string (base64) | Yes | Base64 encoded image containing the face to search |
// Sample cURL request in PHP
$api_key = "your_api_key_here";
$image_path = "path/to/image.jpg";
// Convert image to base64
$image_data = base64_encode(file_get_contents($image_path));
$data = json_encode([
"image" => $image_data
]);
$ch = curl_init("https://mambapanel.com/api/v1/face");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Content-Type: application/json",
"Authorization: Bearer $api_key"
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$response = curl_exec($ch);
curl_close($ch);
$results = json_decode($response, true);
print_r($results);
The API returns responses in JSON format with the following structure:
{
"success": true,
"results": [
{
"score": 95.8,
"source": "Instagram",
"url": "https://example.com/profile",
"base64": "encoded_image_data",
"guid": "instagram_12345"
}
],
"credits_remaining": 49
}
{
"success": false,
"message": "Error description"
}
| HTTP Code | Description |
|---|---|
| 400 | Bad Request - Invalid image format or missing image data |
| 401 | Unauthorized - Invalid API key |
| 402 | Payment Required - Insufficient credits |
| 413 | Request Entity Too Large - Image file too large (max 5MB) |
| 429 | Too Many Requests - Rate limit exceeded |
| 500 | Internal Server Error - API server error |