API-ключ нейросети: что это, где взять и как не потерять деньги

Если вы впервые подключаете модель к своему коду, первым делом упираетесь в слово «ключ». Что это, чем отличается от логина в привычный чат и где его получить? Разберём по порядку: что такое API-ключ нейросети, откуда он берётся у провайдеров и в шлюзе, как проверить, что он работает, и как защитить деньги на балансе.

Что такое API-ключ нейросети

API-ключ — строка символов, по которой сервер узнаёт, кто отправляет запрос и с чьего баланса списывать деньги. У ключей Zukko префикс fetch_, у других сервисов свои префиксы. Ключ передаётся в заголовке запроса, обычно так:

Authorization: Bearer fetch_...

Anthropic SDK шлёт тот же ключ в заголовке x-api-key, шлюз принимает оба варианта. Подробнее об авторизации: Аутентификация↗.

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

Чем ключ отличается от входа в чат

Вход в чат и ключ не взаимозаменяемы. Пароль от аккаунта в чате нельзя вставить в Cursor или в Python-скрипт: нужен именно ключ. Цены и условия подписок на сайтах сервисов меняются, смотрите актуальный тариф на самом сайте, здесь мы их не приводим.

Откуда берут ключ

Напрямую у провайдера. У каждого разработчика моделей (OpenAI, Anthropic, Google, DeepSeek и других) есть консоль для разработчиков, где создаётся ключ, привязывается способ оплаты и пополняется баланс. Условия по странам и способам оплаты определяет сам провайдер, проверяйте их на его сайте. Отдельный ключ у каждого провайдера означает отдельный аккаунт, баланс и счёт.

Через шлюз. Шлюз вроде Zukko даёт один ключ к моделям Claude, GPT, Gemini, DeepSeek, Qwen и GLM и один баланс в долларах. Из России баланс можно пополнить через СБП, картой MasterCard или в криптовалюте. Последовательность:

1. Откройте кабинет↗ и войдите.
2. Пополните баланс (от $1). СБП принимается в рублях по рыночному курсу на момент оплаты, платёжная страница добавляет комиссию 8,5% сверху; карты MasterCard — комиссия около 13%, суммы $2–$594; есть оплата криптовалютой, например USDT.
3. Перейдите на страницу API-ключей↗, нажмите создание ключа, дайте имя.
4. Скопируйте ключ сразу: полный ключ показывается один раз при создании. Потеряли — создайте новый, старый отзовите.

Кредита за регистрацию нет. Есть $0.50 за подписку на канал @zukkopro↗, один раз на Telegram-аккаунт: привяжите Telegram в кабинете, подпишитесь и нажмите «Проверить».

Как проверить, что ключ работает

Самый быстрый тест, не требующий установки библиотек:

export ZUKKO_API_KEY="fetch_ваш_ключ"

curl https://api.zukko.pro/v1/chat/completions \
  -H "Authorization: Bearer $ZUKKO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [{"role": "user", "content": "Ответь одним словом: работает?"}],
    "max_tokens": 20
  }'

Тот же запрос на Python:

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.zukko.pro/v1",
    api_key=os.environ["ZUKKO_API_KEY"],
)
r = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "Ответь одним словом: работает?"}],
    max_tokens=20,
)
print(r.choices[0].message.content)

Если вместо ответа пришла ошибка, смотрите код:

• 401: ключ неверный или с опечаткой (проверьте префикс fetch_ и отсутствие пробелов);
• 402: на балансе не хватает денег;
• 403 model_not_allowed_for_key: для ключа запрещена эта модель;
• 404 model_not_found: неверное имя модели, сверьтесь с GET /v1/models.

Полный разбор: 401, 402, model not found↗.

Как хранить ключ

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

• держите ключ в переменной окружения (OPENAI_API_KEY или своей, как ZUKKO_API_KEY выше), а не в исходниках;
• если используете файл .env, добавьте его в .gitignore до первого коммита;
• никогда не размещайте ключ в браузерном JavaScript: запросы к модели отправляйте с вашего сервера;
• не отправляйте ключ в чат, тикет или мессенджер, даже «временно»;
• для разных проектов заводите разные ключи, тогда утёкший ключ легко отозвать, не ломая остальные.

Подробнее: безопасное хранение API-ключей↗. Если ключ уже утёк, порядок такой: сначала отозвать, потом разбираться.

Лимиты: защита от неприятных сюрпризов

Даже аккуратно хранимый ключ может «сжечь» баланс из-за бага: зациклившийся агент или цикл без условия выхода. Поэтому у каждого ключа в Zukko можно задать:

• дневной лимит в долларах;
• месячный лимит в долларах;
• список разрешённых моделей (allowed_models).

Когда лимит исчерпан, API возвращает 429 с кодом key_daily_limit_reached или key_monthly_limit_reached, и дальнейшие траты по этому ключу остановлены. Простой подход для старта: ключ для экспериментов с лимитом $1–$2 в день и разрешением только на дешёвые модели. Для продакшена создайте отдельный ключ с лимитом, рассчитанным по реальной нагрузке. Как это настроить: дневной и месячный лимит↗.

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

Один ключ подходит ко всем нейросетям?

Ключ провайдера работает только с его моделями. Ключ шлюза Zukko даёт доступ к моделям нескольких разработчиков, список возвращает GET /v1/models.

Можно ли посмотреть ключ повторно?

Нет. Полный ключ показывается один раз при создании. Если потеряли, создайте новый ключ и отзовите старый.

Нужно ли платить за сам ключ?

Нет, платят за использованные токены с баланса. Стоимость запроса считается по ценам модели, актуальные цены смотрите в кабинете или через GET /v1/models.

Что делать, если ключ показали посторонним?

Отзовите его в кабинете и создайте новый. Чтобы начать, создайте ключ на странице API-ключей, поставьте лимит и проверьте его запросом из примера выше.