Получение API ключа

Виртуальный ключ sk-bf-… — твой главный инструмент. Показывается один раз — сохраняй сразу.

📌 О примерах ниже Все упоминания sk-bf-... в этом руководстве — placeholder'ы, не настоящие ключи. Твой реальный ключ выдаётся индивидуально после оплаты тарифа.

Что такое виртуальный ключ

Это длинная строка из 42 символов вида sk-bf-a1b2c3d4-…-xyz. Ты её вставляешь в свой код вместо ключей Anthropic / OpenAI / DeepSeek, и Heimdall сам разруливает запросы к нужному провайдеру.

На один аккаунт можно сделать несколько ключей — например, один для прод-приложения, один для разработки, один для эксперимента. У каждого свой бюджет и список разрешённых моделей.

📌 Аналогия Виртуальный ключ — как банковская карта с лимитом. Можно завести отдельную карту на каждый отдел: «маркетинг — $500/мес», «эксперименты — $50/мес». Если карту скомпрометировали — блокируешь, остальные продолжают работать.

Как создать ключ

Шаг 1 — открой раздел «Ключи»

В личном кабинете на heimdall-llm.com/app/keys нажми «Создать ключ».

Шаг 2 — заполни форму

Параметры:

Имя — для тебя, чтобы не путаться. Например, prod-backend, marketing-bot, experiments.
Месячный бюджет в долларах. По умолчанию $50. Когда расход достигает 80% — приходит письмо-предупреждение. При 100% — ключ автоматически блокируется до следующего месяца.
Разрешённые модели — какие модели этому ключу можно использовать. Например, разрешить только claude-haiku-4-5 (самая дешёвая), чтобы случайный запрос на Opus не сжёг бюджет.
Лимит запросов в минуту (RPM) — защита от багов в твоём коде. По умолчанию 60. Если приложение в цикле случайно дёрнет API 1000 раз — лимит спасёт.

Шаг 3 — нажми «Создать»

Появится экран ожидания «Создаём ключ» — обычно 1–5 секунд. Heimdall в это время регистрирует ключ у провайдера и связывает его с твоим аккаунтом.

Шаг 4 — скопируй секрет

Откроется экран с секретом — длинная строка sk-bf-.... Под ней — кнопка «Копировать» и обязательная галочка «Я скопировал и сохранил ключ». Пока галочка не стоит — кнопка «Готово» неактивна.

🔴 Это критично Секрет показывается только один раз — на 5 минут после создания. После этого ты сможешь видеть только последние 4 символа (например, sk-bf-a7…e409). Если потерял — нужно пересоздать ключ (revoke + new).

Сохрани в менеджер паролей (1Password, Bitwarden).
Или в секреты GitHub Actions / Vercel, если используешь CI/CD.
Или в .env файл локально и сразу добавь в .gitignore.

Где использовать ключ

Если у тебя приложение на Python с OpenAI SDK — поменяй две строки:

from openai import OpenAI
client = OpenAI(
    base_url="https://heimdall-llm.com/v1",   # ← было https://api.openai.com/v1
    api_key="sk-bf-...",                       # ← твой ключ от Heimdall
)
# Дальше всё как обычно
resp = client.chat.completions.create(
    model="claude-haiku-4-5",                  # ← теперь можно claude!
    messages=[{"role":"user","content":"Hello"}],
)

Подробные примеры для Node.js, Go, curl — в API docs.

Можно ли создать сразу несколько ключей

Да — главное не превысить лимит тарифа (Starter = 3 ключа, Pro = 10, Heavy = 50). Сколько уже использовано видно в правом верхнем углу формы.

Отзыв и пересоздание ключа

Если думаешь, что ключ утёк (попал в коммит на GitHub, виден в логах, кто-то увидел поверх плеча) — немедленно отзови. На странице «Ключи» нажми меню ⋮ → «Отозвать». Тебе придётся ввести имя ключа для подтверждения.

Через ~1 секунду ключ перестанет работать — все запросы с ним получат 401. После этого создай новый и обнови в коде / секретах.