Создание API-ключа

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

Кому подходит

Разработчикам — ключ для staging/production сервиса.
Администраторам — контроль моделей и бюджета на ключ.

Требуется роль owner или admin.

Через личный кабинет

Войдите в кабинет и откройте раздел API-ключи.
Заполните форму «Выпустить ключ»:
- Алиас — понятное имя (например, staging-key);
- Модели — через запятую (например, gpt-4o-mini, claude-3-5-sonnet);
- Бюджет ключа — лимит в ₽.
Нажмите «Выпустить ключ».
Сохраните секретную строку (sk-…), если она показана — повторно она не отображается.

Ключ появится в таблице с алиасом, владельцем, моделями и статусом.

Через API

Шаг 1. Войдите и узнайте ID организации

curl -s -X POST https://api.example.com/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"owner@example.com","password":"your-password"}'

TOKEN="<token>"

curl -s https://api.example.com/api/overview \
  -H "Authorization: Bearer $TOKEN" | jq '.organization.id'

Шаг 2. Создайте ключ

ORG_ID="<org-id>"

curl -s -X POST "https://api.example.com/api/organizations/$ORG_ID/api-keys" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "alias": "staging-key",
    "ownerEmail": "developer@example.com",
    "models": ["gpt-4o-mini", "claude-3-5-sonnet"],
    "monthlyBudget": 10000
  }'

Ответ (201) — метаданные ключа и поле secret с секретной строкой (sk-…). Сохраните secret сразу — в последующих запросах он не возвращается. Поле ownerEmail можно опустить — подставится email текущей сессии.

Использование ключа

Подставьте секрет в заголовок при запросах к API моделей (не к API платформы):

Authorization: Bearer sk-…

Пример — в Первый запрос к модели.

Проверка

Ключ появится в GET /api/overview → apiKeys и в журнале аудита (api_key.created).