К содержимому

Список моделей API: идентификаторы, цены и ключ

Публичный каталог моделей в формате API и сведения о вашем ключе.

Список моделей

GET https://relay-llm.ru/v1/models возвращает объект list с моделями публичного каталога. Ключ не нужен: без него запросы ограничиваются по адресу. Если ключ передан, он должен быть действующим. Список не зависит от ограничений ключа по моделям: разрешённые ключу модели показывает GET /v1/key.

Анонимный ответ можно кэшировать на минуту: заголовки Cache-Control: public, max-age=60 и ETag.

GET https://relay-llm.ru/v1/models/MODEL_ID возвращает одну модель публичного каталога по идентификатору. Неизвестная модель даёт ответ 404 с кодом model_not_found.

bash
curl https://relay-llm.ru/v1/models

Поля модели

ПолеТипЧто содержит
idstringИдентификатор модели, его передают в поле model запросов.
objectstringВсегда model.
createdintegerВремя публикации модели, секунды Unix.
owned_bystringВендор модели, например anthropic.

Содержимое публичного ответа

Публичный каталог нужен для поиска модели и возвращает только id, object, created и owned_by. Цены и внутренние параметры в ответ не входят.

Сведения о ключе

GET https://relay-llm.ru/v1/key возвращает сведения о ключе, которым подписан запрос. Деньги приходят десятичными строками в долларах с шестью знаками.

cURL

bash
curl https://relay-llm.ru/v1/key \
  -H "Authorization: Bearer $RELAY_API_KEY"

JSON

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_prefixstringНачало ключа для узнавания: префикс и ещё 6 символов. Полный ключ показывается один раз при создании.
namestringНазвание ключа.
is_activebooleanВсегда true: выключенный ключ до этого метода не доходит.
rate_limit_rpmintegerЛимит запросов в минуту по настройкам ключа и группы. Ограничения нового аккаунта он не учитывает: действующий лимит смотрите в заголовке x-ratelimit-limit-requests.
created_atstringВремя создания, RFC 3339, UTC.
last_used_atstring или nullВремя последнего запроса. Обновляется с небольшой задержкой.
expires_atstring или nullСрок действия, null означает бессрочный ключ.
balancestringДоступный баланс аккаунта в долларах за вычетом резервов. Может быть отрицательным.
spentstringСколько списано через этот ключ за всё время.
total_input_tokensintegerВходные токены за последние 90 дней, включая кэш.
total_output_tokensintegerВыходные токены за последние 90 дней.
request_countintegerЧисло запросов за последние 90 дней.
limitsobjectЛимиты расхода ключа total, day и month (строка в долларах или null) и remaining с остатком по каждому. День и месяц считаются по UTC.
allowed_modelsarray или nullМодели, которые разрешены ключу. null означает, что ограничений нет.

Метод показывает только ваши данные: ключ, лимиты и баланс аккаунта. Запрос без действующего ключа даёт ответ 401.

Готовы? Три шага, чтобы начатьВойдите в консоль · пополните баланс · создайте API Key