### 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 } } } ``` ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.