СПРАВОЧНИК · BenchRU Public API v1.0.0

Публичный API

Публичное чтение каталога BenchRU: лидерборд, модели, harness'ы, наборы, запуски, таксономия. Все ответы — конверт { data, meta } либо { error: { code, message } }. Приватные эталоны и рубрики непубличных split'ов никогда не возвращаются.

Основы

Базовый префикс: /api/v1. Чтение — без аутентификации.
Успешный ответ — конверт { data, meta }, ошибка — { error: { code, message } }.
Лидерборд отдаёт CSV: /api/v1/leaderboard?format=csv.
Приватные эталоны и рубрики непубличных split'ов не возвращаются никогда.
Машиночитаемая спецификация: /api/v1/openapi.json.

GET/api/v1/leaderboard

Лидерборд опубликованных запусков

Параметры GET /leaderboard
Параметр	Тип	Описание
suite	string	slug набора
version	string	точная версия набора
domain	string
capability	string
modality	string
provider	string
access	stringOPEN_WEIGHTS \| PROPRIETARY \| LIMITED
harness	stringwith \| without
verification	stringDEMO \| COMMUNITY_SUBMITTED \| REVIEWED \| VERIFIED \| REPRODUCED
from	string
to	string
search	string
sort	stringscore \| date \| coverage \| model	(по умолчанию: score)
order	stringasc \| desc
page	integer	(по умолчанию: 1)
pageSize	integer	(по умолчанию: 20)
format	stringjson \| csv	csv возвращает text/csv текущего представления (по умолчанию: json)

200 — Ранжированные строки лидерборда (competition ranking внутри версии набора)
400 — Некорректные параметры

Пример запроса

curl "https://benchru.ru/api/v1/leaderboard"

GET/api/v1/models

Каталог версий моделей

Параметры GET /models
Параметр	Тип	Описание
search	string
access	stringOPEN_WEIGHTS \| PROPRIETARY \| LIMITED
provider	string
page	integer	(по умолчанию: 1)
pageSize	integer	(по умолчанию: 20)

200 — Список версий моделей

Пример запроса

curl "https://benchru.ru/api/v1/models"

GET/api/v1/models/{slug}

Карточка семейства моделей

Параметры GET /models/{slug}
Параметр	Тип	Описание
slug*	string

200 — Семейство, версии, последние публичные запуски
404 — Не найдено

Пример запроса

curl "https://benchru.ru/api/v1/models/ru-legal-reasoning"

GET/api/v1/harnesses

Каталог harness'ов и их версий

200 — Список harness'ов

Пример запроса

curl "https://benchru.ru/api/v1/harnesses"

GET/api/v1/benchmarks

Каталог наборов

Параметры GET /benchmarks
Параметр	Тип	Описание
domain	string
capability	string
modality	string
search	string

200 — Наборы с текущей версией и счётчиками split'ов

Пример запроса

curl "https://benchru.ru/api/v1/benchmarks"

GET/api/v1/benchmarks/{slug}

Карточка набора: версии, метрики, публичные кейсы, changelog

Параметры GET /benchmarks/{slug}
Параметр	Тип	Описание
slug*	string

200 — Детали набора; кейсы PRIVATE_HOLDOUT содержат только структурные метаданные
404 — Не найдено

Пример запроса

curl "https://benchru.ru/api/v1/benchmarks/ru-legal-reasoning"

GET/api/v1/runs/{id}

Карточка запуска: манифест, агрегаты, публичные ответы, артефакты, ревью

Параметры GET /runs/{id}
Параметр	Тип	Описание
id*	string

200 — Публичная проекция запуска (без systemPromptText и без скрытых кейсов)
404 — Не найдено

Пример запроса

curl "https://benchru.ru/api/v1/runs/<run-id>"

GET/api/v1/taxonomy

Все справочники таксономии

200 — Домены, способности, модальности, методы оценки, измерения риска

Пример запроса

curl "https://benchru.ru/api/v1/taxonomy"

POST/api/v1/submissions

Публичная заявка (новая модель/набор/результат/правка) — в очередь модерации

201 — Заявка принята
400 — Некорректное тело
429 — Rate limit (5/мин с IP)

Пример запроса

curl -X POST "https://benchru.ru/api/v1/submissions" \
  -H "Content-Type: application/json" \
  -d '{"type":"NEW_MODEL","payload":{"familyName":"…"}}'

Публичный API

Основы

Базовый префикс: /api/v1. Чтение — без аутентификации.

Успешный ответ — конверт { data, meta }, ошибка — { error: { code, message } }.

Лидерборд отдаёт CSV: /api/v1/leaderboard?format=csv.

Приватные эталоны и рубрики непубличных split'ов не возвращаются никогда.

Машиночитаемая спецификация: /api/v1/openapi.json.

Параметр

Тип

Описание

suite

string

slug набора

version

string

точная версия набора

domain

string

capability

string

modality

string

provider

string

access

stringOPEN_WEIGHTS | PROPRIETARY | LIMITED

harness

stringwith | without

verification

stringDEMO | COMMUNITY_SUBMITTED | REVIEWED | VERIFIED | REPRODUCED

from

string

sort

stringscore | date | coverage | model

(по умолчанию: score)

order

stringasc | desc

page

integer

(по умолчанию: 1)

pageSize

integer

(по умолчанию: 20)

format

stringjson | csv

csv возвращает text/csv текущего представления (по умолчанию: json)

Параметр

Тип

Описание

string

access

stringOPEN_WEIGHTS | PROPRIETARY | LIMITED

provider

string

page

integer

(по умолчанию: 1)

pageSize

integer

(по умолчанию: 20)

Параметр

Тип

Описание

slug*

string

Параметр

Тип

Описание

domain

string

capability

string

modality

string

Параметр

Тип

Описание

slug*

string

Параметр

Тип

Описание

id*

string