API key: что такое API-ключ и как его получить

Коротко. API key — это секретная строка, по которой сервис узнаёт вашу программу и понимает, с чьего счёта списывать деньги. Ключ нужен, когда вы хотите подключить нейросеть не в окне чата, а к своему коду, боту, таблице или редактору вроде Cursor. Из России получить API-ключ OpenAI или Anthropic напрямую нельзя, но есть рабочий обходной путь без VPN и зарубежной карты. Разбираем, как устроен ключ, где его взять и как не потерять деньги, если он утечёт.

Что такое API-ключ простыми словами

API — это способ, которым одна программа обращается к другой. Вы открываете чат с нейросетью в браузере, а ваш скрипт отправляет тот же вопрос через API и получает ответ в виде данных. Чтобы сервис понял, кто пришёл, к каждому запросу прикладывается ключ — длинная строка из букв и цифр.

Ключ одновременно решает три задачи:

• Идентификация — сервис знает, чей это запрос.
• Оплата — стоимость запроса списывается с баланса владельца ключа.
• Контроль — у ключа могут быть лимиты, права и срок жизни, его можно отозвать.

Проще всего думать о ключе как о банковской карте для программ: кто знает номер, тот и тратит. Поэтому главное правило — ключ никогда не публикуют.

Зачем нужен API key для нейросети

Если вы пользуетесь нейросетью в чате, ключ не нужен. Он появляется, когда хочется автоматизации:

• подключить ChatGPT или Claude к редактору кода — Cursor, Continue, расширениям для VS Code;
• собрать Telegram-бота, который отвечает клиентам;
• построить цепочку в n8n: письмо пришло — нейросеть разобрала — задача создана;
• прогнать через модель тысячу строк из таблицы: описания товаров, переводы, классификацию отзывов.

Про работу с кодом и выбор модели под программирование подробно рассказано в статье «ИИ для кода», а все возможности для разработчиков в Умке собраны на странице нейросети для программирования.

Где получить API-ключ из России

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

Подробнее о маршрутизаторах моделей — в обзоре «Опен роутер: как пользоваться». Мы агрегатор и заинтересованная сторона, поэтому честно о минусах своего варианта: цена запроса включает наценку, а сама модель та же, что у разработчика, — мы её не дообучаем и не подменяем.

Как получить ключ в Умке

1. Зарегистрируйтесь — карта не нужна, на счёт сразу приходит 60 токенов.
2. В кабинете нажмите «Создать ключ» и дайте ему понятное имя: «бот», «cursor», «n8n».
3. Сразу задайте дневной лимит расхода для этого ключа.
4. Скопируйте ключ и сохраните его в менеджере паролей или в файле .env, а не в коде.

API у Умки OpenAI-совместимый: формат запросов тот же, что у OpenAI, поэтому в существующем коде меняются две строки — адрес и ключ. Пример на Python с официальной библиотекой:

from openai import OpenAI

client = OpenAI(api_key="ВАШ_КЛЮЧ", base_url="https://umka.chat/v1")
r = client.chat.completions.create(
    model="anthropic/claude-sonnet-5",
    messages=[{"role": "user", "content": "Что такое API в двух предложениях?"}],
)
print(r.choices[0].message.content)

Имя модели пишется с префиксом поставщика: anthropic/claude-sonnet-5, а не просто claude-sonnet-5. Так же подключаются Cursor, n8n, LangChain и другие инструменты: в настройках указываете адрес https://umka.chat/v1, ключ и модель. Больше примеров именно для Claude — в статье «Claude в России: доступ, оплата и API».

Как хранить API key и не потерять деньги

Утечка ключа — самая частая и самая дорогая ошибка новичков. Боты круглосуточно сканируют открытые репозитории в поисках ключей и тратят найденные за минуты. Что делать:

• Не храните ключ в коде. Выносите его в переменные окружения, а файл .env добавляйте в .gitignore.
• Один ключ — одна задача. Тогда при утечке вы отзовёте только его, а бот и редактор продолжат работать.
• Ставьте лимит. В Умке у каждого ключа можно задать дневной лимит расхода: если ключ утечёт, потери ограничены этой суммой, а не всем балансом.
• Не вставляйте ключ во фронтенд. Всё, что выполняется в браузере пользователя, видно любому, кто откроет инструменты разработчика.
• Утёк — удаляйте сразу. Отзовите ключ, создайте новый и почистите историю коммитов.

Сколько стоят запросы через API

Сам ключ бесплатный — платите за запросы. Через API в Умке списание идёт с того же баланса, что и в чате, отдельный счёт не нужен, подписки нет. Ответ быстрой модели стоит 1 токен, ответ умной модели — 33 токена, обычная картинка — 35. Пакет за 290 ₽ даёт 725 токенов: это около 20 ответов умной модели или сотни ответов быстрой — для тестов интеграции и небольшого бота хватает с запасом. Крупнее пакеты выгоднее: 690 ₽ — 1 811 токенов, 1 490 ₽ — 4 172, 3 900 ₽ — 11 700. Как устроен пересчёт токенов, разобрано в статье «Токены и кредиты», актуальные цены — на странице тарифов.

Вывод

API key — это пароль и кошелёк для программ одновременно. Он нужен, чтобы подключить нейросеть к коду, боту или автоматизации. Из России ключи OpenAI, Anthropic и Google напрямую не получить, а OpenAI-совместимый агрегатор решает задачу за минуту и оплату в рублях. Главное — храните ключ вне кода и ставьте лимит.

Частые вопросы