عطرنا

التعرّف على العطر من الصورة

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يضيف سجل العطر الكامل لكل احتمال
langar أو 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.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…"
}

أفضل الممارسات

  • اعرض أول ثلاث للمستخدم: الدقة 93.2% ضمن أول ثلاث مقابل 77.6% للأولى.
  • زجاجة واحدة في وسط الصورة، بإضاءة جيدة.
  • أرسل التصحيح إلى POST /v1/vision/feedback عندما يصحّح المستخدم الإجابة.

الباركود

POST /v1/barcode/lookup مع {"ean": "…"} يعيد العطر والحجم (0.2 رصيد). التغطية تتوسع مع وصول بيانات الباركود من المتاجر.

مفتاحك الأول في دقيقتين

سجّل الدخول بحساب عطرنا، أنشئ مفتاح اختبار، وأرسل أول طلب.