Changelog
Credits consumption for free plan
In order to optimize Pl@ntNet resources and due to some misbehaviour by users flooding our servers with bad requests, we made the decision that "free" plan requests returning an error will consume 1 credit as well. This should have a minimal impact if you have a proper usage of the API.
This does not affect "pro" plan.
New AI model
A new model was trained to ensure best results on WCVP floras.
New routes to identify cultivated varieties
Route /v2/varieties/identify is now available to identify cultivated plant varieties.
This feature is currently limited to a small number of well-documented crops and varieties.
Route /v2/varieties lists identifiable varieties.
New routes to identify plant diseases and pests
Route /v2/diseases/identify is now available to identify plant diseases.
This feature currently supports only a limited list of species and pathologies.
Route /v2/diseases lists identifiable diseases.
WCVP v13, new AI model
Kew Gardens' WCVP checklist was updated to v13. A new model was trained to ensure best results on the updated floras, increasing the number of identifiable species to 77k. It brings performance increase on aerial views such as UAV-produced tree crowns pictures, especially in tropical regions.
Results per genus and per family are disabled by default
To ensure best performance, otherResults of /v2/identify routes such as genus and family are now disabled by default. Set detailed to true to obtain those results.
Identification routes return results per genus and per family
Results of identification requests on /v2/identify routes now include a new otherResults field, that contains predicted genera (in otherResults.genus) and predicted families (in otherResults.family), along with associated scores.
Pagination by default on /species routes
Species list routes /v2/species and /v2/{project}/species are now paginated by default. Set page or pageSize to "" (empty string) or null to disable pagination.
Species routes return genus and family
Results of /v2/projects/{project}/species route now include genus and family fields; results of /v2/species only have genus field, since family depends on referential.
Identification routes return top predicted organ per image
Results of identification requests on /v2/identify routes now include a new predictedOrgans field, that contains top predicted organ and associated score for each submitted image.
Error code change on GET /v2/identify
When image(s) URL(s) given to route GET /v2/identify cannot be downloaded, error code is now 400 whatever the reason (no 500 anymore).
Pagination and prefix search on /species routes
Species list routes /v2/species and /v2/{project}/species now accept parameters page and pageSize to drive pagination, and prefix to search among species.
Automatic resizing of input images
Plant images you submit for identification are now automatically resized to 1280px on the smaller side, before being processed by the AI. This is to ensure you get the best possible results from the AI, and that those results are identical between the public version of Pl@ntNet and the API.
Kew Gardens / TDWG based floras
BREAKING CHANGE: We are now using the new floras by default.
Learn here what changes and how to keep using legacy floras / identification engine (with limitations).
Beta: Kew Gardens / TDWG based floras
New identification engine based on Kew Gardens' POWO species list and TDWG's WGSRPD lvl.2 geographical areas: learn here what changes and how to try it
BREAKING CHANGE COMING SOON (Oct. 1st 2023): Default behaviour does not change for now.
New Web UI
- Dashboard helps you keep track of your usage
- Mobile friendly responsive-design
New no-reject parameter
- Add a new
no-rejectparameter to disable rejection of images identified as non-plants - Add optional email address for quota alerts (contractualized users) if you don't want to receive your quota alerts on your account's main email address
Allow usage of API key in client app
Control API key exposure, with domains and IP based access restrictions to allow the usage of API key in client apps (CORS)
Automatic organ detection
- Allow "auto" value for
organsparameter in identify routes organsparameter is now optional, default value is "auto"
Legal update
- Update terms of use
- Add credits page
STA+ gateway
Add STA+ gateway for partners
DarwinCore
Add DarwinCore methods for partners
Add Authenix authentication capability for partners
Registered Authenix-enabled client apps may use an access token for authorization on partners services
Increase free quota
Free accounts now get 500 queries per day
Queries priorization
In case of overload, contractualized accounts still get minimal service
Free account
Remove expiration date of free accounts
Daily usage chart
Find a chart of your daily usage in your account page
New optional parameter
Add include-related-images optional parameter to get similar images
New POST route
- Add
POSTroute to identify local images - Deprecate
v1/identifyroute, you should now usev2/identifyinstead
New v2/identify route
BREAKING CHANGE: Identification score is now in [0, 1[ and not [0, 100[ anymore.
Add new v2/identify route to replace v1/identify