Public identification endpoint

Updated: 28-6-2023

Description

The public identification endpoint can be accessed in the following way. This endpoint is intended for anyone who wants to try out image recognition directly via the API.

Note

Per user, 10 identifications per day are allowed. If you need more, please use the token identification endpoint.

test test

Example request

Get test image
​

Requires curl and jq.

curl \
    -X POST \
    -F "image=@buteo2.jpg" \
    "https://multi-source.identify.biodiversityanalysis.eu/v2/observation/identify" |\
jq

Requires the Python requests library. Available with pip install requests.

import json

import requests


def example_request():
    url = (
        "https://multi-source.identify."
        "biodiversityanalysis.eu/v2/"
        "observation/identify"
    )
    image = "buteo2.jpg"

    with open(image, "rb") as image:
        response = requests.post(
            url=url,
            files={"image": image},
        )
    return response.json()


if __name__ == "__main__":
    json_response = example_request()
    print(json.dumps(json_response, indent=2))

Example response

{
  "api_implementation": {
    "tag": "api-v2:2.0.0-20230424",
    "version": "49476035"
  },
  "generated_by": {
    "datetime": "2023-06-20T13:48:01.965512",
    "parameters": {},
    "tag": "algorithm=msm-eur:1.1-20230619,api=api-v2:2.0.0-20230424",
    "version": "algorithm=df722733dc3eb9647870d237c918cecd0d8aabeb,api=49476035"
  },
  "identification": {
    "image": {
      "confidence": "confident"
    }
  },
  "links": {
    "taxa": {
      "url": "v2/taxa/main_order"
    },
    "taxa_with_filter": {
      "url": "v2/taxa/main_order?id={taxon_id}"
    }
  },
  "media": [
    {
      "filename": "buteo2",
      "id": "image0"
    }
  ],
  "model_implementation": {
    "algorithm_tag": "msm-eur:1.1-20230619",
    "tag": "main_order",
    "version": "df722733dc3eb9647870d237c918cecd0d8aabeb"
  },
  "predictions": [
    {
      "region_group_id": "image0?region=full",
      "taxa": {
        "items": [
          {
            "probability": 0.999987,
            "scientific_name": "Buteo buteo",
            "scientific_name_id": "GBIF:2480537"
          },
          {
            "probability": 1e-5,
            "scientific_name": "Falco rusticolus",
            "scientific_name_id": "GBIF:8069880"
          },
          {
            "probability": 1e-6,
            "scientific_name": "Buteo buteo insularum",
            "scientific_name_id": "GBIF:5844379"
          },
          {
            "probability": 1e-6,
            "scientific_name": "Buteo buteo buteo",
            "scientific_name_id": "GBIF:7191157"
          },
          {
            "probability": 0.0,
            "scientific_name": "Accipiter gentilis",
            "scientific_name_id": "GBIF:2480589"
          },
          {
            "probability": 0.0,
            "scientific_name": "Haliaeetus albicilla",
            "scientific_name_id": "GBIF:2480449"
          },
          {
            "probability": 0.0,
            "scientific_name": "Buteo buteo vulpinus",
            "scientific_name_id": "GBIF:5844375"
          },
          {
            "probability": 0.0,
            "scientific_name": "Anser albifrons albifrons",
            "scientific_name_id": "GBIF:7191107"
          },
          {
            "probability": 0.0,
            "scientific_name": "Sorex araneus/coronatus",
            "scientific_name_id": "NIA:fb23df20659b7b164bb3995b853b26931f80ae87f0b2edab4f0e51d7"
          },
          {
            "probability": 0.0,
            "scientific_name": "Podiceps nigricollis",
            "scientific_name_id": "GBIF:2482065"
          }
        ],
        "type": "multiclass"
      }
    }
  ],
  "region_groups": [
    {
      "id": "image0?region=full",
      "individual_id": "individual0",
      "regions": [
        {
          "box": {
            "x1": 0.166875,
            "x2": 0.833125,
            "y1": 0.0,
            "y2": 1.0
          },
          "id": "image0?region=full",
          "media_id": "image0"
        }
      ]
    }
  ]
}