OurScent

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/identify

L’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

paramDescription
kNombre de candidats (1–10, 5 par défaut)
expand=perfumeAjoute la fiche complète à chaque candidat
langar, 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.jpg
JSON
{
  "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.

Votre première clé en deux minutes

Connectez-vous avec votre compte OurScent, créez une clé de test, envoyez votre premier appel.