Документация API

Ниже — доступные конечные точки Similarfaces. Разверните, чтобы увидеть примеры и формат ответов.

Обнаруживает лица на изображении и возвращает координаты рамок (bounding boxes).

Пример на Python 
import requests

url = "https://similarfaces.me/api/detect-faces"
files = {"image": open("face.jpg", "rb")}
response = requests.post(url, files=files)
print(response.json())
Пример cURL 
curl -X POST https://similarfaces.me/api/detect-faces \
  -F "image=@face.jpg"
Пример ответа
{
  "ok": true,
  "faces": [
    [438, 493, 685, 754]
  ]
}

Сравнивает два изображения и возвращает процент сходства.

Пример на Python 
import requests

url = "https://similarfaces.me/api/compare-faces"
files = {
    "image1": open("face1.jpg", "rb"),
    "image2": open("face2.jpg", "rb")
}
response = requests.post(url, files=files)
print(response.json())
Пример cURL 
curl -X POST https://similarfaces.me/api/compare-faces \
  -F "image1=@face1.jpg" \
  -F "image2=@face2.jpg"
Пример ответа
{
  "ok": true,
  "similarity": "92.3%",
  "same_person": true,
  "face1": [438, 493, 685, 754],
  "face2": [450, 500, 690, 760]
}

Ищет похожие лица в базе данных.

Пример на Python 
import requests

EXAMPLE_TOKEN = "f3939513-488b-424a-b0f2-0aaa4615fc82" # пример токена, не рабочий

url = "https://similarfaces.me/api/search-faces"
files = {"image": open("face.jpg", "rb")}
# В заголовке передаётся токен доступа
headers = {"token": EXAMPLE_TOKEN} 
response = requests.post(url, files=files, headers=headers)
print(response.json())
Пример cURL 
curl -X POST "https://similarfaces.me/api/search-faces" \
  -H "token: EXAMPLE_TOKEN" \
  -F "image=@face.jpg"

Примечание: В примерах указан демонстрационный токен, он не действителен. Используйте реальный токен. Для получения токена свяжитесь с нами.

Пример ответа
{
  "ok": true,
  "results": [
    {
      "similarity": "89%",
      "name": "John Doe",
      "city": "Moscow",
      "social": "https://vk.com/johndoe",
      "image_url": "https://example.com/images/johndoe.jpg"
    }
  ]
}