Список моделей API: идентификаторы, цены и ключ
Публичный каталог моделей в формате API и сведения о вашем ключе.
Список моделей
GET https:// возвращает объект list с моделями публичного каталога. Ключ не нужен: без него запросы ограничиваются по адресу. Если ключ передан, он должен быть действующим. Список не зависит от ограничений ключа по моделям: разрешённые ключу модели показывает GET /.
Анонимный ответ можно кэшировать на минуту: заголовки Cache-Control: public, max-age= и ETag.
GET https:// возвращает одну модель публичного каталога по идентификатору. Неизвестная модель даёт ответ 404 с кодом model_not_found.
curl https://relay-llm.ru/v1/modelsПоля модели
| Поле | Тип | Что содержит |
|---|---|---|
id | string | Идентификатор модели, его передают в поле model запросов. |
object | string | Всегда model. |
created | integer | Время публикации модели, секунды Unix. |
owned_by | string | Вендор модели, например anthropic. |
Содержимое публичного ответа
Публичный каталог нужен для поиска модели и возвращает только id, object, created и owned_by. Цены и внутренние параметры в ответ не входят.
Сведения о ключе
GET https:// возвращает сведения о ключе, которым подписан запрос. Деньги приходят десятичными строками в долларах с шестью знаками.
cURL
curl https://relay-llm.ru/v1/key \
-H "Authorization: Bearer $RELAY_API_KEY"JSON
{
"key_prefix": "sk-rly-3fA9kL",
"name": "laptop",
"is_active": true,
"rate_limit_rpm": 120,
"created_at": "2026-10-01T10:00:00Z",
"last_used_at": "2026-10-01T12:31:07Z",
"expires_at": null,
"balance": "12.345678",
"spent": "7.654322",
"total_input_tokens": 1234567,
"total_output_tokens": 234567,
"request_count": 842,
"limits": {
"total": "50.000000",
"day": null,
"month": "50.000000",
"remaining": {
"total": "42.345678",
"day": null,
"month": "42.345678"
}
},
"allowed_models": null
}| Поле | Тип | Что содержит |
|---|---|---|
key_prefix | string | Начало ключа для узнавания: префикс и ещё 6 символов. Полный ключ показывается один раз при создании. |
name | string | Название ключа. |
is_active | boolean | Всегда true: выключенный ключ до этого метода не доходит. |
rate_limit_rpm | integer | Лимит запросов в минуту по настройкам ключа и группы. Ограничения нового аккаунта он не учитывает: действующий лимит смотрите в заголовке x-ratelimit-limit-requests. |
created_at | string | Время создания, RFC 3339, UTC. |
last_used_at | string или null | Время последнего запроса. Обновляется с небольшой задержкой. |
expires_at | string или null | Срок действия, null означает бессрочный ключ. |
balance | string | Доступный баланс аккаунта в долларах за вычетом резервов. Может быть отрицательным. |
spent | string | Сколько списано через этот ключ за всё время. |
total_input_tokens | integer | Входные токены за последние 90 дней, включая кэш. |
total_output_tokens | integer | Выходные токены за последние 90 дней. |
request_count | integer | Число запросов за последние 90 дней. |
limits | object | Лимиты расхода ключа total, day и month (строка в долларах или null) и remaining с остатком по каждому. День и месяц считаются по UTC. |
allowed_models | array или null | Модели, которые разрешены ключу. null означает, что ограничений нет. |
Метод показывает только ваши данные: ключ, лимиты и баланс аккаунта. Запрос без действующего ключа даёт ответ 401.