Ключи управления и активность · UltraGPT API

Ключи управления и активность

Создайте ключ со scope "management", чтобы выдавать ключи из своего бэкенда — по одному на клиента, со своим лимитом расходов (limit + limit_reset: день, неделя, месяц или без сброса), списком моделей и лимитами запросов — через /keys, и управлять пресетами через /presets. Ключи управления не вызывают модели. GET /activity возвращает расход по дням, моделям и эндпоинтам за 30 дней (всё пространство для ключа управления, иначе — только этот ключ), с фильтрами по дате, ключу и пользователю. POST /generations/lookup возвращает точную стоимость до 1000 запросов сразу — удобно для выставления счетов своим клиентам.

# With a management key: provision a key per customer, capped at $20/month
curl https://api.ultragpt.pro/v1/keys -H "Authorization: Bearer $ULTRAGPT_MANAGEMENT_KEY" -H "Content-Type: application/json" \
  -d '{ "name": "customer-42", "limit": 20, "allowed_models": ["gpt-5-mini"], "rpm_limit": 60 }'
# -> { "data": { "id": "...", "limit_remaining": 20, ... }, "key": "ugpt_live_..." }  (shown once)

curl https://api.ultragpt.pro/v1/keys -H "Authorization: Bearer $ULTRAGPT_MANAGEMENT_KEY"              # list
curl -X PATCH https://api.ultragpt.pro/v1/keys/KEY_ID -d '{ "limit": 50 }' ...                         # update
curl -X DELETE https://api.ultragpt.pro/v1/keys/KEY_ID -H "Authorization: Bearer $ULTRAGPT_MANAGEMENT_KEY"  # revoke

# Daily usage per model for the last 30 days (?date=, ?key_id=, ?user=)
curl https://api.ultragpt.pro/v1/activity -H "Authorization: Bearer $ULTRAGPT_MANAGEMENT_KEY"

# Exact cost of up to 1000 requests at once (any key, incl. read-only)
curl https://api.ultragpt.pro/v1/generations/lookup -H "Authorization: Bearer $ULTRAGPT_API_KEY" -H "Content-Type: application/json" \
  -d '{ "ids": ["chatcmpl-...", "chatcmpl-..."] }'