Plant.id

https://plant.id/docs
Admin
Plant.id is a machine learning-based API service for identifying plant species and assessing plant...
Tokens:3,819
Snippets:21
Trust Score:8.5
Update:1 month ago
Show doc for...
Tokens:
Raw
### POST /identify

Source: https://plant.id/docs

Creates a new plant identification request. Supports both JSON and multipart/form-data payloads. The response includes identification results and optionally health assessment.

```APIDOC
## POST /identify

### Description
Creates a new plant identification request. The request can be sent using either `application/json` or `multipart/form-data`. The response includes the identification results, and optionally health assessment.

### Method
POST

### Endpoint
/identify

### Parameters
#### Headers
- **Api-Key** (string) - Required - Your API key, obtained from the Admin Panel.

#### Request Body (application/json)
- **images** (array of strings) - Required - One or more images of the plant, either as Base64-encoded strings or public URLs.
- **latitude** (float) - Optional - Geographic coordinate, increases identification accuracy.
- **longitude** (float) - Optional - Geographic coordinate, increases identification accuracy.
- **similar_images** (boolean) - Optional - If `true`, the model also selects images similar to the provided images for each suggestion.
- **custom_id** (integer) - Optional - A unique identifier, can be used to access the identification results.
- **datetime** (string) - Optional - Date when the images were taken, in ISO format with variable precision (e.g. `2023-06-22` or `2023-06-22T11:28`).
- **suggestion_filter** (object) - Optional - Restricts the output to a specified list of classes (taxonomy, region or plant type). Format: `{"classification": "FILTER_NAME"}`. Lists can be combined with logical operators and parentheses.
- **classification_level** (string) - Optional - Adjusts the taxonomy level of the response. Values: `species` (default), `all`, `genus`.
- **classification_raw** (boolean) - Optional - If `true`, suggestions are kept in 3 original taxonomy levels without postprocessing. Response structure changes.
- **health** (string) - Optional - Controls health assessment inclusion. Values: `only`, `auto`, `all`.
- **disease_level** (string) - Optional - Controls specificity of health suggestions. Values: `all` (default), `general`.

#### Request Body (multipart/form-data)
- **images** (file) - Required - One or more image files. Field names are not important.
- **latitude** (text) - Optional - Geographic coordinate.
- **longitude** (text) - Optional - Geographic coordinate.
- **similar_images** (text) - Optional - Boolean value.
- **custom_id** (text) - Optional - Integer value.
- **datetime** (text) - Optional - ISO date string.
- **suggestion_filter** (text) - Optional - JSON object string.
- **classification_level** (text) - Optional - String value.
- **classification_raw** (text) - Optional - Boolean value.
- **health** (text) - Optional - String value.
- **disease_level** (text) - Optional - String value.

### Request Example
```json
{
  "images": ["base64_encoded_image", "https://example.com/plant.jpg"],
  "latitude": 52.2297,
  "longitude": 21.0122,
  "similar_images": true,
  "custom_id": 12345,
  "datetime": "2023-06-22",
  "suggestion_filter": {"classification": "vegetable"},
  "classification_level": "species",
  "classification_raw": false,
  "health": "all",
  "disease_level": "all"
}
```

### Response
#### Success Response (200)
The response contains the identification results. The exact structure depends on the request parameters (e.g., `classification_raw`, `health`).

#### Response Example
```json
{
  "result": {
    "classification": {
      "suggestions": [
        {
          "name": "Plant species",
          "probability": 0.95
        }
      ]
    },
    "health_assessment": {
      "is_healthy": true
    }
  }
}
```
```
Tokens:
Raw