Vision : identifier un parfum par photo
POST /v1/vision/identify : envoyez une photo de flacon et recevez le parfum exact et ses cinq candidats les plus proches. Paramètres, réponse et bonnes pratiques.
POST https://api.ourscent.online/v1/vision/identifyL’image
- Un corps brut avec Content-Type image/jpeg, image/png ou image/webp ;
- ou du multipart avec un champ image ;
- ou du JSON : {"image_url": "https://…"} ou {"image_base64": "…"}.
- Jusqu’à 10 Mo.
Paramètres
| param | Description |
|---|---|
k | Nombre de candidats (1–10, 5 par défaut) |
expand=perfume | Ajoute la fiche complète à chaque candidat |
lang | ar, en ou fr pour les noms de notes et descriptions |
curl -X POST "https://api.ourscent.online/v1/vision/identify?k=5" \
-H "Authorization: Bearer os_live_…" \
-H "Content-Type: image/jpeg" \
--data-binary @bottle.jpgJSON
{
"model": "c-20261122",
"candidates": [
{
"perfume_id": "Khamrah-Lattafa-Perfumes-Lattafa-Perfumes",
"score": 0.91,
"name": "Khamrah",
"name_ar": "خمرة",
"brand": { "id": "lattafa", "name": "Lattafa", "name_ar": "لطافة" },
"thumbnail_url": "https://ourscent.online/perfume-images/…/w400.webp"
},
{ "perfume_id": "Khamrah-Qahwa-Lattafa-Perfumes-Lattafa-Perfumes", "score": 0.06, "…": "…" }
],
"request_id": "req_8f2c…"
}Bonnes pratiques
- Montrez le top 3 : la précision est de 93,2 % dans le top 3 contre 77,6 % au premier choix.
- Un seul flacon au centre, bien éclairé.
- Envoyez les corrections à POST /v1/vision/feedback quand l’utilisateur corrige la réponse.
Code-barres
POST /v1/barcode/lookup avec {"ean": "…"} renvoie le parfum et la contenance (0,2 crédit). La couverture s’étend à mesure que les codes-barres des boutiques arrivent.