face detection API

Copyimport requests

response = requests.post(
    "https://precisioncounter.com/api/v1/detect-faces",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    files={"image": open("sample.png", "rb")}
)

data = response.json()
for face in data["faces"]:
    print(f"{face['name']} ({face['confidence']:.0%})")

Copyconst fs = require("fs");
const FormData = require("form-data");

const form = new FormData();
form.append("image", fs.createReadStream("sample.png"));

const response = await fetch(
  "https://precisioncounter.com/api/v1/detect-faces",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      ...form.getHeaders()
    },
    body: form
  }
);

const data = await response.json();
data.faces.forEach(f => console.log(`${f.name} (${f.confidence})`));

Copyimport requests
import sys

API_KEY = "YOUR_API_KEY"
API_URL = "https://precisioncounter.com/api/v1/detect-faces"

def detect_faces(input_path, max_faces=5):
    """Detect faces from an image file."""
    with open(input_path, "rb") as img:
        response = requests.post(
            API_URL,
            headers={"Authorization": f"Bearer {API_KEY}"},
            files={"image": img},
            data={"max_faces": max_faces, "include_boxes": "true"}
        )

    if response.status_code == 200:
        data = response.json()
        for face in data["faces"]:
            print(f"{face['name']} - {face['confidence']:.0%} confidence")
            print(f"  Category: {face['category']}")
            if face.get("box"):
              print(f"  Box: {face['box']}")
        print(f"Credits remaining: {response.headers.get('X-Credits-Remaining')}")
    else:
        print(f"Error {response.status_code}: {response.json()['error']}")

detect_faces("sample.png")

Copyconst fs = require("fs");
const FormData = require("form-data");
const fetch = require("node-fetch");

const API_KEY = "YOUR_API_KEY";
const API_URL = "https://precisioncounter.com/api/v1/detect-faces";

async function detectfaces(inputPath, maxResults = 5) {
  const form = new FormData();
  form.append("image", fs.createReadStream(inputPath));
  form.append("max_faces", String(maxResults));
  form.append("include_boxes", "true");

  const response = await fetch(API_URL, {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${API_KEY}`,
      ...form.getHeaders()
    },
    body: form
  });

  if (response.ok) {
    const data = await response.json();
    data.faces.forEach(face => {
      console.log(`${face.name} - ${(face.confidence * 100).toFixed(0)}%`);
      console.log(`  Category: ${face.category}`);
      if (face.box) console.log(`  Box: ${JSON.stringify(face.box)}`);
    });
    console.log(`Credits: ${response.headers.get("x-credits-remaining")}`);
  } else {
    const error = await response.json();
    console.error(`Error ${response.status}: ${error.error}`);
  }
}

detectfaces("sample.png");

Copy<?php
$api_key = "YOUR_API_KEY";
$url = "https://precisioncounter.com/api/v1/detect-faces";

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => $url,
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer $api_key"
    ],
    CURLOPT_POSTFIELDS => [
        "image" => new CURLFile("sample.png"),
        "max_faces" => "5",
        "include_boxes" => "true"
    ]
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 200) {
    $data = json_decode($response, true);
    foreach ($data["faces"] as $face) {
        echo $face["name"] . " - " . ($face["confidence"] * 100) . "% confidence\n";
        echo "  Category: " . $face["category"] . "\n";
        if (isset($face["box"])) {
          echo "  Box: " . json_encode($face["box"]) . "\n";
        }
    }
} else {
    echo "Error $httpCode: $response\n";
}
?>

Copypackage main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io"
    "mime/multipart"
    "net/http"
    "os"
)

type faceResult struct {
    Name       string   `json:"name"`
    Confidence float64  `json:"confidence"`
    Category   string   `json:"category"`
  Box        map[string]int `json:"box"`
}

type Response struct {
  faces        []faceResult `json:"faces"`
  ImageWidth     int            `json:"image_width"`
  ImageHeight    int            `json:"image_height"`
  ProcessingTime int            `json:"processing_time_ms"`
}

func detectfaces(inputPath string) error {
    file, _ := os.Open(inputPath)
    defer file.Close()

    body := &bytes.Buffer{}
    writer := multipart.NewWriter(body)
    part, _ := writer.CreateFormFile("image", inputPath)
    io.Copy(part, file)
    writer.WriteField("max_faces", "5")
    writer.Close()

    req, _ := http.NewRequest("POST",
        "https://precisioncounter.com/api/v1/detect-faces", body)
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Content-Type", writer.FormDataContentType())

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        return err
    }
    defer resp.Body.Close()

    if resp.StatusCode == 200 {
        var result Response
        json.NewDecoder(resp.Body).Decode(&result)
        for _, face := range result.faces {
            fmt.Printf("%s - %.0f%% confidence\n", face.Name, face.Confidence*100)
        }
    }
    return nil
}

func main() {
    detectfaces("sample.png")
}

Copyrequire "net/http"
require "uri"
require "json"

api_key = "YOUR_API_KEY"
uri = URI("https://precisioncounter.com/api/v1/detect-faces")

form_data = [
  ["image", File.open("sample.png", "rb")],
  ["max_faces", "5"],
  ["include_boxes", "true"]
]

req = Net::HTTP::Post.new(uri)
req["Authorization"] = "Bearer #{api_key}"
req.set_form(form_data, "multipart/form-data")

res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(req)
end

if res.code == "200"
  data = JSON.parse(res.body)
  data["faces"].each do |face|
    puts "#{face['name']} - #{(face['confidence'] * 100).round}% confidence"
    puts "  Category: #{face['category']}"
    puts "  Box: #{face['box']}" if face['box']
  end
else
  puts "Error #{res.code}: #{res.body}"
end

Copyusing System.Text.Json;

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");

using var form = new MultipartFormDataContent();
var imageContent = new ByteArrayContent(File.ReadAllBytes("sample.png"));
imageContent.Headers.ContentType = new("image/png");
form.Add(imageContent, "image", "sample.png");
form.Add(new StringContent("5"), "max_faces");
form.Add(new StringContent("true"), "include_boxes");

var response = await client.PostAsync(
    "https://precisioncounter.com/api/v1/detect-faces", form);

if (response.IsSuccessStatusCode)
{
    var json = await response.Content.ReadAsStringAsync();
    var data = JsonSerializer.Deserialize<JsonElement>(json);
    foreach (var face in data.GetProperty("faces").EnumerateArray())
    {
        Console.WriteLine($"{face.GetProperty("name")} - {face.GetProperty("confidence")}");
    }
}