{"openapi":"3.1.0","info":{"title":"OnPrem World API","version":"2026-10-14","description":"Read-only data about running LLMs locally: hardware specs (with source URLs), open models, and memory/speed estimates for any model × hardware pair. No key needed. Data licence CC BY 4.0, please link back.","license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"}},"servers":[{"url":"https://onpremworld.com"}],"paths":{"/api/v1/hardware":{"get":{"operationId":"listHardware","summary":"All GPUs, Macs and mini PCs with memory size and bandwidth","responses":{"200":{"description":"Hardware list","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/hardware/{id}":{"get":{"operationId":"getHardware","summary":"One device","parameters":[{"name":"id","in":"path","required":true,"description":"Hardware ID, e.g. rtx-4090","schema":{"type":"string"}}],"responses":{"200":{"description":"Hardware","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/models":{"get":{"operationId":"listModels","summary":"Open-weight models with parameters, licence and Ollama tag","responses":{"200":{"description":"Model list","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/models/{id}":{"get":{"operationId":"getModel","summary":"One model","parameters":[{"name":"id","in":"path","required":true,"description":"Model ID, e.g. qwen3-32b","schema":{"type":"string"}}],"responses":{"200":{"description":"Model","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/news":{"get":{"operationId":"listNews","summary":"Latest local-AI news (model, runtime and hardware releases), newest first, with bilingual summaries and the official source URL","parameters":[{"name":"category","in":"query","required":false,"schema":{"type":"string","enum":["model-release","runtime-release","hardware","price","other"]},"description":"Only this category"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":50},"description":"Number of items"}],"responses":{"200":{"description":"News items","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/fit":{"get":{"operationId":"checkFit","summary":"Will this model run on this hardware? Memory per quantization and estimated tokens/s","parameters":[{"name":"model","in":"query","required":true,"schema":{"type":"string"},"description":"Model ID"},{"name":"hardware","in":"query","required":true,"schema":{"type":"string"},"description":"Hardware ID"},{"name":"memory","in":"query","required":false,"schema":{"type":"number"},"description":"Memory configuration in GB (defaults to the largest)"},{"name":"context","in":"query","required":false,"schema":{"type":"integer","default":8192},"description":"Context length in tokens"}],"responses":{"200":{"description":"Fit result","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/prices":{"get":{"operationId":"listPrices","summary":"Latest GPU, Mac and mini PC prices in Taiwan (TWD) and the US (USD), each with the shop URL and check date, price per GB and a value score; plus the raw observations","parameters":[{"name":"hardware","in":"query","required":false,"schema":{"type":"string"},"description":"Hardware ID, e.g. rtx-5090"},{"name":"region","in":"query","required":false,"schema":{"type":"string","enum":["TW","US"]}},{"name":"condition","in":"query","required":false,"schema":{"type":"string","enum":["new","used"]}},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["consumer","workstation","mac-minipc"]}}],"responses":{"200":{"description":"Prices","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/data/prices/observations.json":{"get":{"operationId":"downloadPrices","summary":"The full price dataset as versioned in git (CC BY 4.0)","responses":{"200":{"description":"Price observations","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"externalDocs":{"description":"Methodology","url":"https://onpremworld.com/en/methodology"}}