Docs

APIProcjene

Vaš model

Procjene naučene na vašim cijenama — prodajnim, otkupnim ili procjenama — uz tržišnu vrijednost.

Kompanija s Enterprise ugovorom može na platformi (Vaš model) učitati svoje cijene — prodaje, otkupe, oglase ili procjene — i dobiti model koji vrednuje kao ona. Model ne uči ispočetka: zadržava Cifrin tržišni model i uči samo razliku između vaših cijena i tržišta, po marki, starosti, kilometraži i drugim osobinama.

Kako ga API koristi

  • Kad je vaš model u upotrebi, procjene vaših ključeva dolaze iz njega (valuation_model: "auto", podrazumijevano).
  • valued_by.kind je custom, a valued_by.price_kind kaže koje cijene je učio — pa šta vrijednost znači.
  • standard_value je tržišna vrijednost istog vozila, za poređenje.
  • Pošaljite valuation_model: "standard" kad trebate samo tržišnu vrijednost.
POST/v1/valuations
curl -X POST "https://api.cifra.ba/v1/valuations" \
  -H "Authorization: Bearer $CIFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vehicle_type": "car",
    "make": "volkswagen",
    "model": "golf_7",
    "year": 2017,
    "mileage_km": 148000,
    "power_kw": 85,
    "engine_cc": 1598,
    "fuel": "diesel",
    "transmission": "manual",
    "body_type": "hatchback",
    "city": "Sarajevo",
    "include": []
  }'
valued_by
{
  "kind": "custom",
  "version": "custom-17-v3",
  "custom_model_id": 17,
  "name": "Otkup 2026",
  "price_kind": "purchase",
  "base_version": "car-20261017-1"
}

Kad nešto nije sigurno

UpozorenjeZnačenje
custom_model_unseen_makeU vašim podacima nema te marke: vrijednost je tržišna, pomjerena za vašu opštu razliku.
custom_model_few_examplesMalo vozila tog modela u vašim podacima: procjena se više oslanja na tržište.
custom_model_unavailableVaš model trenutno nije mogao odgovoriti; vrijednost je standardnog. Procjena nikad ne pada zbog toga.
Vaši podaci nikad ne ulaze u Cifrin tržišni model i ne vide ih druge kompanije. Model prati tržište: kad Cifra uvede novi tržišni model, vaš se automatski obnavlja na njemu i prelazi tek kad prođe provjeru.
Model kompanije se uključuje ugovorom i na platformi; API ga samo koristi. Praćena vozila i slična vozila uvijek vrednuje tržišni model.