---
title: "Информация о текущем ключе"
method: GET
path: "/v1/key"
tags: ["Management"]
---

# Информация о текущем ключе

`GET /v1/key`

## Request

- Base URL: `https://api.hubris.pw`
- URL: `https://api.hubris.pw/v1/key`
- Auth: HTTP bearer

Самоинтроспекция ключа, которым сделан запрос: имя, лимит расхода и период его сброса, расход в текущем периоде, остаток лимита и баланс аккаунта. Работает с обычным API-ключом — management-ключ не нужен.

## Response `200`

Данные текущего ключа.

- object
  - `data` object, required
    - `name` string, required
    - `key_prefix` string, required
    - `key_type` 'inference' | 'management', required
    - `disabled` boolean, required
    - `limit_kopecks` integer, nullable, required: Лимит расхода ключа в копейках за период limit_period. null = без лимита.
    - `limit_period` 'day' | 'week' | 'month' | 'none', required
    - `spent_period_kopecks` integer, required: Потрачено ключом в текущем периоде, в копейках.
    - `limit_remaining_kopecks` integer, nullable, required: Сколько ещё можно потратить в текущем периоде: лимит минус траты минус резервы роликов в работе, не меньше 0. null — без лимита.
    - `period_reset_at` string, nullable, required: Момент следующего сброса (ISO 8601); null для limit_period=none.
    - `daily_limit_kopecks` integer, nullable, required: Устаревшее: limit_kopecks при limit_period=day, иначе null.
    - `spent_24h_kopecks` integer, required: Устаревшее: равно spent_period_kopecks.
    - `read_only` boolean, required: Ключ только для чтения: запросы к моделям ему запрещены (403 key_read_only).
    - `allowed_ips` string[], nullable, required: Привязка к адресу: адреса и подсети, с которых ключ принимает запросы; null — с любого.
    - `balance_kopecks` integer, required: Текущий баланс аккаунта в копейках.
    - `created_at` string, required

## Other responses

- `401`: Невалидный ключ.
- `403`: OAuth-токены не поддерживаются этим эндпоинтом.

---

[API](https://skmtc.dev/hubris/apis/hubris-api.md) · [All operations](https://skmtc.dev/hubris/apis/hubris-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hubris/apis/hubris-api/revisions/79ea91ed8f10?raw)
