Single-species identification

General information

Single-species identification returns a top-list of probable plant species, presented in decreasing order of confidence score.

Confidence scores are between 0 and 1.

Up to 5 input images can be sent in a single request. Only images with image/jpeg or image/png mimetype are allowed, and total POST size (sum of input image files sizes) cannot exceed 50 MB.

Routes list

/v2/identify/{project}
- Identify a plant species from one or more pictures

See OpenAPI doc for details.

Input

Project

Also known as "floras" or "referentials", "projects" are lists of species-level taxa, related to a geographical area or a theme.

Set project to any value from /v2/projects to get more accurate results, or to all by default.

Set type to legacy only if you explicitely wish to run identification on a legacy project.

See FAQ for details about projects and projects types.

Images and organs

images are binary files, in JPG or PNG format. You can submit up to 5 images representing the same plant individual. Use the parameter multiple times to do so.

Set organs to values among the following to indicate which plant organ is represented by each input image:

leaf
flower
fruit
bark

Use value auto to let AI detect the organ based on the image.

Number of values for organs must match number of input images. Each organ is associated to an image in the order given. If multiple images represent the same organ, use the same value multiple times.

Setting include-related-images to true will return a list of most-similar images for each probable species.

Set no-reject to true to prevent the service from rejecting your image when most probable AI identification result is not a plant (human, object…) ; see FAQ (chapter "rejection") for details.

Set nb-results to an integer >= 1 to restrict size of output list of probable species. Fewer results improve response time.

Other input parameters

Set lang to a language code returned by /v2/languages route to get contextualized results, such as common names.

Ouput format

Output is of the following form.

{
  "query": {},
  "predictedOrgans": [],
  "bestMatch": "Ajuga genevensis L.",
  "results": [],
  "version": "2025-01-17 (7.3)",
  "remainingIdentificationRequests": 498,
  (…)
}

query summarizes input.

results is the list of predicted probable plant species, by order of confidence score decreasing.

bestMatch is a shortcut to the complete species name of the top 1 probable species identified.

predictedOrgans gives the top1 of predicted organs for each input image.

version gives the version of the AI engine that processed your request.

remainingIdentificationRequests informs you about your quota consumption for the current day.

cURL examples

POST `/v2/identify`

curl -X POST 'https://my-api.plantnet.org/v2/identify/all?api-key=YOUR_API_KEY' -F 'images=@/path/to/image.jpg'

{
  "query": {
    "project": "all",
    "images": [
      "5440fc78d0dd7c382ee5d743eafb68d9"
    ],
    "organs": [
      "auto"
    ],
    "includeRelatedImages": false,
    "noReject": false,
    "type": null
  },
  "predictedOrgans": [
    {
      "image": "5440fc78d0dd7c382ee5d743eafb68d9",
      "filename": "image.jpg",
      "organ": "flower",
      "score": 0.66656
    }
  ],
  "language": "en",
  "preferedReferential": "k-world-flora",
  "bestMatch": "Ajuga genevensis L.",
  "results": [
    {
      "score": 0.90734,
      "species": {
        "scientificNameWithoutAuthor": "Ajuga genevensis",
        "scientificNameAuthorship": "L.",
        "genus": {
          "scientificNameWithoutAuthor": "Ajuga",
          "scientificNameAuthorship": "",
          "scientificName": "Ajuga"
        },
        "family": {
          "scientificNameWithoutAuthor": "Lamiaceae",
          "scientificNameAuthorship": "",
          "scientificName": "Lamiaceae"
        },
        "commonNames": [
          "Blue bugleweed",
          "Blue bugle",
          "Geneva Bugle"
        ],
        "scientificName": "Ajuga genevensis L."
      },
      "gbif": {
        "id": "2927079"
      },
      "powo": {
        "id": "444576-1"
      }
    },
    {
      "score": 0.05933,
      "species": {
        "scientificNameWithoutAuthor": "Ajuga orientalis",
        "scientificNameAuthorship": "L.",
        "genus": {
          "scientificNameWithoutAuthor": "Ajuga",
          "scientificNameAuthorship": "",
          "scientificName": "Ajuga"
        },
        "family": {
          "scientificNameWithoutAuthor": "Lamiaceae",
          "scientificNameAuthorship": "",
          "scientificName": "Lamiaceae"
        },
        "commonNames": [
          "Eastern bugle"
        ],
        "scientificName": "Ajuga orientalis L."
      },
      "gbif": {
        "id": "7307097"
      },
      "powo": {
        "id": "444639-1"
      }
    },
    (…)
  ],
  "version": "2025-01-17 (7.3)",
  "remainingIdentificationRequests": 498
}