Insect.id

Create identification

Send images for identification. See above for description of response and request body.

post/insect_id/identification

Request

Base URL: https://agents.kindwise.com
URL: https://agents.kindwise.com/insect_id/identification
Auth: none required

Query parameters

detailsstring

Example:common_names,url,description,image

comma separetad list of requested insect details (optional) see detail description above

languagestring

Example:en

two-letter ISO 639-1 language code (optional, default en) - language of localized insect details can be multiple (up to 3), separated by comma - i.e. (en,de,sv)

asyncstring

Example:true

boolean (optional) - if true: request does not wait for identification to complete and response does not contain result section; result can be later retrieved by next endpoint

Request body

imagesstring[]

latitudenumber

longitudenumber

similar_imagesboolean

Response

Basic / All details / Multilingual details / With suggestion filter / With custom_id / With custom datetime / Async / mutlipart/form-data

access_tokenstring

completednumber nullable

creatednumber

custom_idnumber nullable

model_versionstring

sla_compliant_clientboolean

sla_compliant_systemboolean

statusstring

Example response

{
  "access_token": "404GtKcjq7BLtT7",
  "completed": 1690793121.504057,
  "created": 1690793121.072337,
  "input": {
    "datetime": "2023-07-31T08:45:21.072337+00:00",
    "latitude": 49.207,
    "longitude": 16.608,
    "similar_images": true
  },
  "model_version": "insect_id:1.0.1",
  "result": {
    "classification": {
      "suggestions": [
        {
          "details": {
            "entity_id": "7ff37dfa393e597b",
            "language": "en",
            "gbif_id": 5743122,
            "inaturalist_id": 61749,
            "rank": "species",
            "taxonomy": {
              "kingdom": "Animalia",
              "phylum": "Arthropoda",
              "class": "Insecta",
              "order": "Coleoptera",
              "family": "Lucanidae",
              "genus": "Lucanus"
            },
            "common_names": [
              "stag beetle",
              "European Stag Beetle"
            ],
            "description": {
              "value": "Lucanus cervus, known as the European stag beetle, is one of the best-known species in Western Europe...",
              "citation": "https://en.wikipedia.org/wiki/Lucanus_cervus",
              "license_name": "CC BY-SA 3.0",
              "license_url": "https://creativecommons.org/licenses/by-sa/3.0/"
            },
            "image": {
              "value": "Lucanus cervus, known as the European stag beetle, is one of the best-known species in Western Europe...",
              "citation": "https://en.wikipedia.org/wiki/Lucanus_cervus",
              "license_name": "CC BY-SA 3.0",
              "license_url": "https://creativecommons.org/licenses/by-sa/3.0/"
            },
            "images": [
              {
                "value": "Lucanus cervus, known as the European stag beetle, is one of the best-known species in Western Europe...",
                "citation": "https://en.wikipedia.org/wiki/Lucanus_cervus",
                "license_name": "CC BY-SA 3.0",
                "license_url": "https://creativecommons.org/licenses/by-sa/3.0/"
              }
            ],
            "danger": [
              "nonvenomous",
              "bites or stings"
            ],
            "danger_description": "This nonvenomous species poses minimal danger to human health. While it can deliver a bite, the bite is generally not harmful and typically results in only minor discomfort. Overall, it is not considered a significant threat to humans.",
            "role": [
              "pollinator"
            ],
            "url": "https://en.wikipedia.org/wiki/Lucanus_cervus"
          }
        }
      ]
    },
    "is_insect": {
      "binary": true,
      "probability": 0.94256556,
      "threshold": 0.5
    }
  },
  "sla_compliant_client": true,
  "sla_compliant_system": true,
  "status": "COMPLETED"
}

Changes

No recorded changes to this operation across all 1 revision of this API.