التعرّف على العطر من الصورة
POST /v1/vision/identify: أرسل صورة زجاجة واحصل على العطر بالضبط وأقرب خمسة احتمالات. المعاملات والإجابة وأفضل الممارسات.
POST https://api.ourscent.online/v1/vision/identifyالصورة
- جسم خام مع Content-Type: image/jpeg أو image/png أو image/webp؛
- أو multipart بحقل image؛
- أو JSON: {"image_url": "https://…"} أو {"image_base64": "…"}.
- الحد الأقصى 10 ميغابايت.
المعاملات
| param | الوصف |
|---|---|
k | عدد الاحتمالات (1–10، الافتراضي 5) |
expand=perfume | يضيف سجل العطر الكامل لكل احتمال |
lang | ar أو en أو fr لأسماء النوتات والأوصاف |
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…"
}أفضل الممارسات
- اعرض أول ثلاث للمستخدم: الدقة 93.2% ضمن أول ثلاث مقابل 77.6% للأولى.
- زجاجة واحدة في وسط الصورة، بإضاءة جيدة.
- أرسل التصحيح إلى POST /v1/vision/feedback عندما يصحّح المستخدم الإجابة.
الباركود
POST /v1/barcode/lookup مع {"ean": "…"} يعيد العطر والحجم (0.2 رصيد). التغطية تتوسع مع وصول بيانات الباركود من المتاجر.