API нейросети: как получить ключ и начать

По данным Яндекс Вордстата, в августе 2026 года запрос «api нейросетей» набирает 2 340 показов в месяц, а уточнение «бесплатные api нейросетей» — ещё 855. Выдача по обоим забита лендингами, которые продают доступ и не объясняют механику. Ниже — как API нейросети устроен изнутри: чем ключ отличается от логина, как считаются лимиты и что происходит с деньгами при ошибке.

Что такое API нейросети простыми словами?

API нейросети — это способ обратиться к модели из программы, а не через сайт. Ваш код отправляет HTTP-запрос с текстом задачи, сервер провайдера возвращает JSON с ответом. Никакого интерфейса, кнопок и браузера: только запрос и ответ.

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

Ради этого API и подключают. Внутри сервиса поддержки, генератора описаний товаров, бота или скрипта, который каждое утро собирает сводку. Всё это агентные сценарии разной глубины, и в основе каждого лежит один и тот же вызов модели.

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

Как получить API-ключ и отправить первый запрос?

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

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

Дальше нужны два параметра вместо всей интеграции: адрес сервера и ключ. Наш API совместим с форматом OpenAI, поэтому в готовом коде меняются ровно две строки — base_url на https://api.trackly.one/v1 и api_key на свой. Официальные библиотеки OpenAI для Python и JavaScript работают без правок.

Проверить связку удобнее всего запросом GET /v1/models: он отдаёт список доступных моделей, ничего не генерирует и баланс не трогает. Идентификатор в ответе выглядит как провайдер/модель — например, google/gemini-2.5-flash или anthropic/claude-sonnet-4.6. Именно эту строку потом подставляют в поле model. Пошаговые примеры на curl, Python и JavaScript собраны в документации для разработчиков.

Почему у каждого провайдера свой формат запроса

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

Провайдер	Как передаётся ключ	Что ещё обязательно
OpenAI	Authorization: Bearer <ключ>	content-type: application/json
Anthropic	x-api-key: <ключ>	Заголовок anthropic-version, например 2023-06-01
Google Gemini	Ключ проекта в Google AI Studio	Отдельный слой совместимости для OpenAI-кода

Документация Claude API прямо перечисляет обязательные заголовки: x-api-key, anthropic-version и content-type. Забыли версию — запрос не пройдёт, хотя ключ верный. У Google своя логика: есть родной формат и есть слой совместимости с OpenAI, через который тот же код работает без переписывания.

Отсюда и смысл агрегатора. Три провайдера — это три схемы авторизации, три формата ошибок и три счёта на оплату. Один OpenAI-совместимый шлюз сводит их к одному ключу, одному адресу и одному балансу в рублях. Список моделей с описаниями и возможностями лежит в каталоге для разработчиков.

Как считаются лимиты API нейросетей?

Лимиты меряются в трёх измерениях сразу, и превышение любого из них даёт ошибку. Документация Gemini API называет их RPM (запросов в минуту), TPM (входных токенов в минуту) и RPD (запросов в сутки). Проверяются они независимо: уложились по токенам, но отправили на один запрос больше нормы — всё равно откажут.

Там же спрятана деталь, которая ломает планы: у Google лимиты считаются на проект, а не на ключ. Завести пять ключей и получить пятикратную квоту не выйдет. Суточные квоты RPD обнуляются в полночь по тихоокеанскому времени, что для российского часового пояса приходится на середину дня.

У нас схема проще. Общий лимит — 60 запросов в минуту на аккаунт, и это одна корзина на все модальности: текст, картинки, видео и озвучка тратят её вместе. В каждом ответе приходят заголовки x-ratelimit-limit-requests, x-ratelimit-remaining-requests и x-ratelimit-reset-requests — по ним видно остаток и время сброса окна. При превышении сервер отдаёт 429 и заголовок Retry-After с числом секунд до следующей попытки.

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

Есть ли бесплатный API нейросети?

Бесплатные API существуют, но у каждого стоит цена не в деньгах. Формата три, и путать их не стоит.

Первый — бесплатный тариф провайдера. У Gemini API он есть официально, с собственными лимитами RPM и RPD, ниже платных. Подходит для прототипа, не подходит для продакшена: квота кончается ровно в тот момент, когда сервисом начали пользоваться.

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

Третий — «бесплатные ключи», которые ищут по запросу «api ключ нейросети бесплатно». Здесь под бесплатным обычно понимают чужой ключ из утёкшего репозитория или прокси неизвестного происхождения. Такой ключ отзовут при первой же проверке владельцем, а весь ваш трафик по дороге прочитает тот, кто держит прокси. Отправлять туда клиентские данные нельзя.

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

Что происходит при ошибке и списываются ли деньги?

При ошибке деньги не списываются: проверка баланса идёт до запуска генерации, а списание — после успешного ответа по фактическому usage. Провайдер упал, параметры не те, баланс кончился — транзакции не будет. У видео своя точка расчёта: списание происходит в момент, когда задача переходит в статус завершённой, а упавшая генерация бесплатна.

Сам ответ приходит в OpenAI-формате: объект error с полями message, type, code и param. Поле param показывает, какое именно поле запроса виновато, — по нему ошибку чинят, не гадая.

Полезно заранее разложить коды на две группы. Ретраить осмысленно 429 (после паузы из Retry-After), 502 upstream_error и 504 upstream_timeout — тут виноват верхний уровень цепочки, повтор безопасен. Не ретраить 401 invalid_api_key, 402 insufficient_quota, 404 model_not_found и 400 unsupported_capability: запрос сам по себе не исправится, повтор просто съест квоту.

Отдельно стоит 409 video_not_ready — это не сбой, а сигнал «задача ещё считается, опрашивай статус дальше». Полная таблица кодов с описанием ситуаций — в гайде по ошибкам API.

Как хранить ключ и не потерять деньги

Ключ равен доступу к вашему балансу, поэтому правил хранения четыре.

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

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

Если ключ всё-таки засветился, порядок действий короткий: отозвать в кабинете, создать новый, обновить в переменных окружения. Хеш в базе восстановить оригинал не даёт, но утёкшая строка работает до момента отзыва. Подробнее о формате ключей и заголовке Authorization — в гайде по аутентификации.

Источники

• Claude API overview — обязательные заголовки x-api-key и anthropic-version (проверено 7 августа 2026).
• Gemini API rate limits — измерения RPM/TPM/RPD, лимиты на проект, сброс RPD в полночь по тихоокеанскому времени (проверено 7 августа 2026).
• Gemini API: OpenAI compatibility — слой совместимости с OpenAI-форматом (проверено 7 августа 2026).
• openai/openai-python — официальная библиотека, которая работает с любым OpenAI-совместимым адресом (проверено 7 августа 2026).
• Частотность запросов — Яндекс Вордстат, регион Россия, август 2026.