Создавайте и отзывайте ключи через API, меняйте разрешения и бюджеты. Те же настройки доступны на странице API-ключи.

Авторизация: ключ управления

Создайте ключ на странице API Управления и передавайте его в Authorization: Bearer $KODIK_MANAGEMENT_KEY. Для списка нужно разрешение keys:read, для создания, изменения и отзыва — keys:write. Эти разрешения независимы.

Обычный ключ с gateway:read или gateway:write не даёт права управлять ключами. Ключ управления действует только в организации, где он создан. Раскрытие существующих секретов через /reveal не поддерживается для ключей управления; просмотр обычного ключа доступен администратору в панели API-ключи.

Эндпоинты управления ключами

Совместимые пути: GET/POST /v1/keys и DELETE /v1/keys/{key_id}. Для обновления используйте /v1/api-keys. Отдельного GET по ID и отдельного endpoint ротации нет: создайте новый ключ, переключите приложение и отзовите старый.

Поля создания и обновления

Типы указаны для JSON-тела запроса. Метка req означает обязательное поле при создании; default — значение при создании, если поле не передано.

В PATCH пропущенное поле остаётся без изменений. null разрешён для models_allowlist, credit_limit, daily_credit_limit и expires_at. Поле is_active не принимается: для отзыва используйте DELETE.

Примеры cURL

Задайте KODIK_MANAGEMENT_KEY в окружении доверенного серверного процесса. Для всех примеров ниже нужны keys:read и keys:write. Примеры создания и изменения ниже выполняют реальные операции при запуске.

# Список ключей, включая отозванные
curl --fail-with-body -sS \
  'https://api.kodikrouter.ru/v1/api-keys?include_inactive=true' \
  -H "Authorization: Bearer $KODIK_MANAGEMENT_KEY"

# Создание обычного ключа для запросов к моделям
curl --fail-with-body -sS https://api.kodikrouter.ru/v1/api-keys \
  -H "Authorization: Bearer $KODIK_MANAGEMENT_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"name":"Production app","scopes":["gateway:write"],"environment":"production","rate_limit_rpm":10}'

Сохраните secret из ответа в менеджере секретов и используйте его как KODIK_API_KEY для запросов к моделям. Сохраните id как KODIK_KEY_ID для изменения или отзыва ключа; ID и секрет — разные значения. Не сохраняйте полный ответ с секретом в общедоступных логах.

# Изменение названия и дневного бюджета существующего ключа
curl --fail-with-body -sS -X PATCH \
  "https://api.kodikrouter.ru/v1/api-keys/$KODIK_KEY_ID" \
  -H "Authorization: Bearer $KODIK_MANAGEMENT_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"name":"Production app updated","daily_credit_limit":"500.000000"}'

# Отзыв обычного API-ключа
curl --fail-with-body -sS -X DELETE \
  "https://api.kodikrouter.ru/v1/api-keys/$KODIK_KEY_ID" \
  -H "Authorization: Bearer $KODIK_MANAGEMENT_KEY"

Что возвращает список

Каждый элемент содержит id, name, prefix, masked_secret, scopes, models_allowlist, environment, rate_limit_rpm, credit_limit, daily_credit_limit, is_active, created_at, expires_at и last_used_at. Полного секрета в списке нет; сохраните secret из ответа создания. Повторный просмотр обычного ключа доступен в панели API-ключи, если его секрет сохранён на сервере.

Для контроля бюджета используйте day_spend_rub, month_spend_rub, day_limit_reached, month_limit_reached, day_resets_at и month_resets_at. Дневной период начинается в 00:00 UTC; месячный отсчитывается от даты создания ключа. Ориентируйтесь на возвращаемые даты сброса.

Ошибки

400 — неверные поля или превышен допустимый RPM тарифа; 401 — ключ управления неверен, отозван или истёк; 403 — недостаточно прав; 404 — ключ не найден в вашей организации; 429 — слишком много запросов.

Для запросов, токенов и расходов по конкретному ключу перейдите к статистике и аналитике ниже.

Получайте расходы, токены и историю запросов для своих отчётов. Готовые графики доступны на странице Использование.

Авторизация и область данных

Для отчётов и автоматизации используйте ключ управления с usage:read в заголовке Authorization: Bearer. Создать его можно на странице API Управления. Обычные API-ключи с gateway:read также поддерживают чтение статистики; gateway:write не включает это разрешение.

Эндпоинты статистики

Фильтры и страницы

Для summary и by-model без дат используется диапазон от 30 дней до даты to (по умолчанию сегодня) до самой даты to включительно. Для /usage и export без обеих дат доступны записи за всё время. Если задана только одна дата, to по умолчанию — сегодня, from — за 30 дней до to. Дата to включена целиком. Задавайте обе даты для воспроизводимых отчётов.

Для журнала activity передавайте next_cursor из ответа в следующий запрос без изменений и сохраняйте те же фильтры; null означает конец списка. Для /usage увеличивайте offset на limit до неполной или пустой страницы. Параметр api_key_id — ID из списка ключей, а не секрет. История отозванных ключей доступна по тому же ID.

Расходы по одному ключу

Задайте KODIK_MANAGEMENT_KEY с usage:read и KODIK_KEY_ID — ID обычного API-ключа, который нужно анализировать. Получить ID можно через список ключей с разрешением keys:read. Замените даты на нужный период.

curl --fail-with-body -sS --get \
  https://api.kodikrouter.ru/v1/usage/summary \
  -H "Authorization: Bearer $KODIK_MANAGEMENT_KEY" \
  --data-urlencode "api_key_id=$KODIK_KEY_ID" \
  --data-urlencode 'from=2026-11-01' \
  --data-urlencode 'to=2026-11-04' \
  --data-urlencode 'granularity=day'

Сокращённый пример ответа; points содержит показатели для каждого периода с записями, totals — для всего диапазона:

{
  "from": "2026-11-01",
  "to": "2026-11-04",
  "granularity": "day",
  "points": [{"date":"2026-11-04","requests":2,"tokens_in":100,"tokens_out":50,"cost_rub_exact":"0.123456"}],
  "totals": {"requests":2,"tokens_in":100,"tokens_out":50,"cost_rub_exact":"0.123456","currency":"RUB","masked_entity_count":0}
}

Выгрузка JSON

curl --fail-with-body -sS --get \
  https://api.kodikrouter.ru/v1/usage/export.json \
  -H "Authorization: Bearer $KODIK_MANAGEMENT_KEY" \
  --data-urlencode "api_key_id=$KODIK_KEY_ID" \
  --data-urlencode 'from=2026-11-01' \
  --data-urlencode 'to=2026-11-04' \
  --output usage.json

Валюты и точность

Для точных расчётов используйте cost_rub_exact — списание в рублях с шестью знаками после запятой. cost_rub — форматированная сумма для отображения; в JSON-экспорте она содержит точное значение. Денежные поля передаются строками: используйте decimal-арифметику.

provider_cost_usd — база расчёта в USD до конвертации и наценки; она берётся из ответа провайдера либо рассчитывается по каталогу. Устаревшее cost_usd — алиас рублёвой суммы, а не доллары. currency и cost_usd_currency имеют значение RUB, provider_cost_currency — USD. В экспорте избыточные алиасы удалены.

Если запрос не проходит

401 — неверный, отозванный или истёкший токен/ключ; 403 — отсутствует gateway:read у обычного ключа, usage:read у ключа управления или доступ к организации; 402 — достигнут бюджет API-ключа, проверяемый также при чтении статистики; 400 — некорректные параметры; 429 — превышен лимит запросов. Для просмотра статистики при исчерпанном бюджете ключа используйте ключ управления с usage:read.