Список API Key

GET /api/open/v1/keys

Параметры запроса

Параметр	Где	Тип	Обязательный	По умолчанию	Описание
`p`	query	integer	Нет	`1`	Номер страницы, от 1 до 1000000
`page_size`	query	integer	Нет	`10`	Элементов на странице, от 1 до 1000
`name`	query	string	Нет	—	Фильтр по точному имени Key; для нескольких значений повторяйте параметр (`?name=a&name=b`). Запятые не поддерживаются, так как имена могут их содержать

Явно переданные неверные p / page_size возвращают 400; см. Пагинация.

Каждый параметр с несколькими значениями принимает не более 50 значений; при превышении возвращается 400 invalid_request. Если указан name, поле total отражает отфильтрованный результат.

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

curl "https://www.routeapi.ai/api/open/v1/keys?p=1&page_size=20&name=bot" \
  -H "Authorization: Bearer $ROUTEAPI_MANAGEMENT_KEY"

Пример ответа

{
  "success": true,
  "message": "",
  "data": {
    "items": [
      {
        "id": 12,
        "name": "bot",
        "key": "sk-abcd**********wxyz",
        "status": 1,
        "created_time": 1729000000,
        "accessed_time": 1729000000,
        "expired_time": -1,
        "remain_amount": 10.00,
        "unlimited": false,
        "used_amount": 0.00,
        "model_limits_enabled": true,
        "model_limits": "gpt-4o,gpt-4o-mini",
        "allow_ips": ""
      }
    ],
    "total": 1,
    "page": 1,
    "page_size": 20
  }
}

Поля ответа

Поле	Тип	Описание
`items`	array	Объекты Key, отсортированные по ID по убыванию (сначала новые)
`total`	integer	Общее количество Key, соответствующих фильтрам
`page`	integer	Текущий номер страницы
`page_size`	integer	Фактическое количество элементов на странице

Объект Key

Все эндпоинты API платформы, возвращающие Key, используют одну и ту же структуру:

Поле	Тип	Описание
`id`	integer	ID Key, используется как `:id` в других эндпоинтах
`name`	string	Имя
`key`	string	Значение Key с префиксом `sk-`; маскируется везде, кроме эндпоинта создания и Получить полный API Key
`status`	integer	`1` включён, `2` отключён (остановлен вручную; можно снова включить), `3` истёк, `4` исчерпан; включайте и отключайте через эндпоинт обновления (только `1` / `2`)
`created_time`	integer	Время создания, unix-секунды
`accessed_time`	integer	Время последнего использования, unix-секунды
`expired_time`	integer	Срок действия, unix-секунды; `-1` означает бессрочно
`remain_amount`	number	Оставшаяся доступная сумма, два знака после запятой; не имеет смысла, когда `unlimited` равно `true`
`unlimited`	boolean	Безлимитный ли Key
`used_amount`	number	Израсходованная сумма, два знака после запятой
`model_limits_enabled`	boolean	Включён ли белый список моделей
`model_limits`	string	Разрешённые модели через запятую
`allow_ips`	string	Разрешённые IP, по одному на строку; пустая строка означает отсутствие ограничений

Примечания

Суммы указаны в валюте отображения сайта, см. Получить баланс.
Общие коды ошибок см. в Ошибки и лимиты.