{"openapi":"3.1.0","info":{"title":"BenchRU Public API","version":"1.0.0","description":"Публичное чтение каталога BenchRU: лидерборд, модели, harness'ы, наборы, запуски, таксономия. Все ответы — конверт { data, meta } либо { error: { code, message } }. Приватные эталоны и рубрики непубличных split'ов никогда не возвращаются."},"servers":[{"url":"/api/v1"}],"paths":{"/leaderboard":{"get":{"summary":"Лидерборд опубликованных запусков","parameters":[{"name":"suite","in":"query","schema":{"type":"string"},"description":"slug набора"},{"name":"version","in":"query","schema":{"type":"string","pattern":"^\\d+\\.\\d+\\.\\d+$"},"description":"точная версия набора"},{"name":"domain","in":"query","schema":{"type":"string"}},{"name":"capability","in":"query","schema":{"type":"string"}},{"name":"modality","in":"query","schema":{"type":"string"}},{"name":"provider","in":"query","schema":{"type":"string"}},{"name":"access","in":"query","schema":{"type":"string","enum":["OPEN_WEIGHTS","PROPRIETARY","LIMITED"]}},{"name":"harness","in":"query","schema":{"type":"string","enum":["with","without"]}},{"name":"verification","in":"query","schema":{"type":"string","enum":["DEMO","COMMUNITY_SUBMITTED","REVIEWED","VERIFIED","REPRODUCED"]}},{"name":"from","in":"query","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","schema":{"type":"string","format":"date"}},{"name":"search","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string","enum":["score","date","coverage","model"],"default":"score"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"]}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"pageSize","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"format","in":"query","schema":{"type":"string","enum":["json","csv"],"default":"json"},"description":"csv возвращает text/csv текущего представления"}],"responses":{"200":{"description":"Ранжированные строки лидерборда (competition ranking внутри версии набора)","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"rank":{"type":["integer","null"]},"runId":{"type":"string"},"fingerprint":{"type":"string"},"publishedAt":{"type":["string","null"],"format":"date-time"},"isDemo":{"type":"boolean"},"verificationLevel":{"type":"string","enum":["DEMO","COMMUNITY_SUBMITTED","REVIEWED","VERIFIED","REPRODUCED"]},"model":{"type":"object","properties":{"familySlug":{"type":"string"},"familyName":{"type":"string"},"versionSlug":{"type":"string"},"versionLabel":{"type":"string"}}},"harness":{"type":["object","null"]},"provider":{"type":["object","null"]},"benchmark":{"type":"object","properties":{"suiteSlug":{"type":"string"},"suiteName":{"type":"string"},"versionLabel":{"type":"string"}}},"dimensions":{"type":"object","description":"Unrounded 0..1 scores per dimension; null = not measured","properties":{"quality":{"type":["number","null"]},"reliability":{"type":["number","null"]},"safety":{"type":["number","null"]},"efficiency":{"type":["number","null"]}}},"display":{"type":"object","description":"Display scale 0–100, one decimal, half away from zero","properties":{"quality":{"type":["number","null"]},"reliability":{"type":["number","null"]},"safety":{"type":["number","null"]},"efficiency":{"type":["number","null"]}}},"coverage":{"type":"number"},"sampleCount":{"type":"integer"},"overall":{"type":"object","properties":{"score":{"type":["number","null"]},"display":{"type":["number","null"]},"efficiencyMeasured":{"type":"boolean"},"reason":{"type":["string","null"]}}},"comparability":{"type":"object","properties":{"benchmarkVersionId":{"type":"string"},"evaluationProfileId":{"type":["string","null"]},"harnessVersionId":{"type":["string","null"]}}}}}},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}}}}}}},"400":{"description":"Некорректные параметры","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","example":"VALIDATION"},"message":{"type":"string"}}}}}}}}}}},"/models":{"get":{"summary":"Каталог версий моделей","parameters":[{"name":"search","in":"query","schema":{"type":"string"}},{"name":"access","in":"query","schema":{"type":"string","enum":["OPEN_WEIGHTS","PROPRIETARY","LIMITED"]}},{"name":"provider","in":"query","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"pageSize","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}}],"responses":{"200":{"description":"Список версий моделей","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object"}},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}}}}}}}}}},"/models/{slug}":{"get":{"summary":"Карточка семейства моделей","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Семейство, версии, последние публичные запуски","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"}}}}}},"404":{"description":"Не найдено","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","example":"VALIDATION"},"message":{"type":"string"}}}}}}}}}}},"/harnesses":{"get":{"summary":"Каталог harness'ов и их версий","responses":{"200":{"description":"Список harness'ов","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object"}}}}}}}}}},"/benchmarks":{"get":{"summary":"Каталог наборов","parameters":[{"name":"domain","in":"query","schema":{"type":"string"}},{"name":"capability","in":"query","schema":{"type":"string"}},{"name":"modality","in":"query","schema":{"type":"string"}},{"name":"search","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Наборы с текущей версией и счётчиками split'ов","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object"}},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}}}}}}}}}},"/benchmarks/{slug}":{"get":{"summary":"Карточка набора: версии, метрики, публичные кейсы, changelog","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Детали набора; кейсы PRIVATE_HOLDOUT содержат только структурные метаданные","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"}}}}}},"404":{"description":"Не найдено","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","example":"VALIDATION"},"message":{"type":"string"}}}}}}}}}}},"/runs/{id}":{"get":{"summary":"Карточка запуска: манифест, агрегаты, публичные ответы, артефакты, ревью","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Публичная проекция запуска (без systemPromptText и без скрытых кейсов)","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"}}}}}},"404":{"description":"Не найдено","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","example":"VALIDATION"},"message":{"type":"string"}}}}}}}}}}},"/taxonomy":{"get":{"summary":"Все справочники таксономии","responses":{"200":{"description":"Домены, способности, модальности, методы оценки, измерения риска","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"}}}}}}}}},"/submissions":{"post":{"summary":"Публичная заявка (новая модель/набор/результат/правка) — в очередь модерации","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["type","payload"],"properties":{"type":{"type":"string","enum":["NEW_MODEL","NEW_BENCHMARK","RUN_RESULT","METADATA_FIX"]},"payload":{"type":"object"},"contactEmail":{"type":"string","format":"email"}}}}}},"responses":{"201":{"description":"Заявка принята","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"}}}}}},"400":{"description":"Некорректное тело","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","example":"VALIDATION"},"message":{"type":"string"}}}}}}}},"429":{"description":"Rate limit (5/мин с IP)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","example":"VALIDATION"},"message":{"type":"string"}}}}}}}}}}}}}