Если вам нужен api нейросети бесплатно для первого теста, начинать можно без оплаты и без привязки банковской карты. В этой инструкции пройдём весь путь от регистрации до первого успешного ответа: выпустим ключ, проверим пробный баланс, отправим запрос и разберём ошибки 401, 402 и 429. Раздел API понадобится для выпуска ключа.
Первый ключ выдаётся после входа в аккаунт, а на баланс при его выпуске начисляется 50 ₽. Этого достаточно, например, для одного запуска операции «Оживить фото» за 25 ₽, одной операции «Изменить фото по описанию» за 35 ₽ или нескольких более дешёвых операций. Оплата взимается за запуск, без абонентской платы и минимального платежа.
Ниже используется базовый адрес https://genius-bot.ru/wp-json/genius/v1. Все примеры рассчитаны на обычный HTTP-запрос с заголовком Authorization: Bearer <ключ>, поэтому после получения ключа можно сразу переходить к проверке API.
Что нужно до старта: почта, две минуты и никакой карты
Для старта нужен аккаунт с почтой и несколько минут на регистрацию и выпуск ключа. Банковская карта для получения первого ключа не требуется: при его выпуске сервис начисляет на баланс 50 ₽ пробных средств. Поэтому получить api ключ нейросети можно до первого платежа.
Сначала зарегистрируйтесь и войдите в аккаунт. После авторизации откройте раздел API по адресу https://genius-bot.ru/api/. Именно там выдаётся ключ, который затем используется во всех запросах к API.
Перед первым запросом удобно сразу проверить, что ключ скопирован полностью. В HTTP-запросах он передаётся как Bearer-токен: после слова Bearer ставится пробел, затем сам ключ. Формат заголовка выглядит так: Authorization: Bearer ВАШ_КЛЮЧ.
Есть ещё один момент, который стоит учесть до копирования ключа. Сервис показывает выданный ключ один раз, поэтому сохраните его в безопасном месте сразу после выпуска. Если вставлять его в терминал или редактор кода для проверки, не добавляйте его в публичный репозиторий и не отправляйте в сообщения, где он останется доступен другим людям.
Выпуск ключа: где он лежит и почему показывается один раз
После входа перейдите в раздел API и выпустите ключ. Там же находится информация, необходимая для подключения: базовый адрес API и сам ключ авторизации. Ключ нужно скопировать сразу, поскольку сервис показывает его один раз.
Для API используется единый базовый URL: https://genius-bot.ru/wp-json/genius/v1. Например, маршрут для запуска операции имеет полный адрес https://genius-bot.ru/wp-json/genius/v1/generate, а для получения списка доступных операций используется https://genius-bot.ru/wp-json/genius/v1/services.
На этом этапе полезно не запускать сразу тяжёлую операцию, а сначала проверить авторизацию. Для этого есть GET-маршрут /services. Он возвращает список операций и их цены, поэтому одним запросом можно проверить и ключ, и доступ к API, не создавая задачу.
Пробный баланс в 50 ₽ начисляется при выпуске первого ключа. Это не абонентский тариф: списание происходит за запуск операции, а минимального платежа нет. Цены операций указаны за один запуск, за исключением озвучки текста, где стоимость указана за 1000 знаков.
| Операция | Цена |
|---|---|
| Картинка по описанию (image) | 9 ₽ |
| Оживить фото (photo-video) | 25 ₽ |
| Изменить фото по описанию (image-edit) | 35 ₽ |
| Увеличить качество фото (upscale) | 50 ₽ |
| Видео по описанию (video) | 119 ₽ |
| Создать музыку (music) | 59 ₽ |
| Расшифровка записи (stt) | 10 ₽ |
| Звук из видео (ytaudio) | 0 ₽ |
| Говорящий аватар (avatar) | 120 ₽ |
| Убрать вокал (vocal) | 45 ₽ |
| Убрать шум (denoise) | 36 ₽ |
| Звук по описанию (sfx) | 9 ₽ |
| Озвучка текста (tts) | 18 ₽ за 1000 знаков |
Первый запрос: проверяем ключ на списке операций
Начнём с самого безопасного теста: GET-запроса к /services. Он не запускает генерацию, а возвращает список доступных операций и цены. Если ответ приходит без ошибки авторизации, ключ работает.
Для curl достаточно подставить полученный ключ вместо ВАШ_КЛЮЧ. Сам запрос выглядит так:
curl -X GET "https://genius-bot.ru/wp-json/genius/v1/services" \
-H "Authorization: Bearer ВАШ_КЛЮЧ"Если вы получили JSON со списком операций, первый этап подключения завершён. Заодно можно проверить, что цены в ответе соответствуют тем, которые вы собирались использовать в приложении.
Тот же тест удобно сделать из Python через библиотеку requests. Ключ лучше получать из переменной окружения, а не хранить непосредственно в исходнике:
import os
import requests
BASE_URL = "https://genius-bot.ru/wp-json/genius/v1"
API_KEY = os.environ["GENIUS_API_KEY"]
response = requests.get(
f"{BASE_URL}/services",
headers={"Authorization": f"Bearer {API_KEY}"},
timeout=30,
)
print(response.status_code)
print(response.json())В этом примере код ответа выводится до тела ответа. При успешном запросе вы увидите HTTP-статус и JSON со списком операций. Если вместо него пришла ошибка, сначала проверьте значение переменной с ключом и сам заголовок авторизации.
Для проверки текущего остатка есть отдельный маршрут GET /balance. Полный URL формируется по тому же принципу: https://genius-bot.ru/wp-json/genius/v1/balance. Этот запрос удобен перед запуском платной операции, если приложение должно заранее убедиться, что на балансе достаточно средств.
Запуск задачи и получение результата по идентификатору
После проверки ключа можно перейти к запуску операции. Для этого используется POST /generate. Конкретные параметры зависят от операции, а сам маршрут возвращает идентификатор задачи, по которому затем можно узнать её состояние и результат.
Логика интеграции здесь двухэтапная. Сначала приложение отправляет запрос на /generate и получает ID задачи, затем обращается к GET /tasks/{id}. Это позволяет не держать один HTTP-запрос открытым всё время выполнения операции.
В практическом коде идентификатор нужно сохранить сразу после ответа API. Например, если ответ содержит ID задачи, приложение может периодически запрашивать /tasks/{id} и проверять состояние. Когда задача готова, в ответе будет доступен результат.
Для файлов предусмотрен отдельный маршрут POST /uploads. Он используется для загрузки файла и получения ссылки, которую затем можно применять в соответствующей операции. Такой подход особенно удобен для сценариев, где исходный файл находится на сервере вашего приложения, а не передаётся непосредственно из браузера.
Если постоянный опрос статуса не подходит, у API есть необязательный webhook. В запрос можно передать параметр callback_url, после чего при готовности задачи на указанный адрес приходит POST-запрос. Для веб-приложения это позволяет построить обработку результата через обычный endpoint.
Отдельно стоит учитывать лимит частоты: на один ключ допускается не более 60 запросов в минуту. Если приложение опрашивает статус нескольких задач одновременно, счётчик запросов нужно учитывать не только для запуска операций, но и для последующих обращений к API.
Для чатовых сценариев предусмотрена совместимость с форматом OpenAI: доступны POST /chat/completions и GET /models. В клиентской библиотеке для такого подключения достаточно изменить base_url и ключ. Тариф чата составляет 40 ₽ за миллион токенов запроса и 400 ₽ за миллион токенов ответа.
Ошибки 401, 402 и 429: что они значат и что делать
Ошибка 401 относится к авторизации. В первую очередь проверьте, что ключ передаётся именно в заголовке Authorization и используется формат Bearer <ключ>. Также проверьте, что в переменной окружения нет лишних кавычек, пробелов или случайного переноса строки.
Если ключ был скопирован не полностью или приложение отправляет другое значение, запрос не сможет пройти проверку авторизации. Не стоит вставлять ключ непосредственно в URL или передавать его в произвольном параметре запроса: для API предусмотрен именно заголовок Authorization.
Ошибка 402 связана с оплатой операции и недостаточным балансом для запуска. Сначала запросите GET /balance и проверьте остаток, затем сопоставьте его с ценой нужной операции. Например, операция «Оживить фото» стоит 25 ₽, а «Картинка по описанию» — 9 ₽.
Пробные 50 ₽ начисляются при выпуске первого ключа, поэтому для тестирования можно использовать их без предварительного платежа. Но пробный баланс не означает, что любая операция будет доступна: если стоимость конкретного запуска превышает текущий остаток, запрос потребует пополнения.
Ошибка 429 означает превышение ограничения частоты запросов. Для одного ключа установлен предел в 60 запросов в минуту. Если приложение опрашивает состояние задачи слишком часто, увеличьте интервал между запросами и не запускайте параллельные циклы, которые обращаются к одному и тому же endpoint без необходимости.
Для диагностики удобно всегда сохранять три вещи: HTTP-статус, тело ответа и endpoint, на который отправлялся запрос. При 401 сначала проверяется ключ, при 402 — баланс и стоимость операции, при 429 — частота запросов за последнюю минуту. Такой порядок сокращает время поиска ошибки, потому что каждая из трёх проблем находится на своём уровне.
Куда девать ключ в реальном проекте, чтобы не утёк в репозиторий
Не записывайте API-ключ непосредственно в Python-файл, JavaScript-код или конфигурацию, которая попадает в Git. В приведённом выше примере Python ключ читается из переменной окружения GENIUS_API_KEY. Сам исходный код при этом можно хранить в репозитории без значения секрета.
Для локальной разработки достаточно задать переменную окружения перед запуском программы. В серверном приложении ключ также должен передаваться через конфигурацию окружения или другой механизм хранения секретов, а не быть частью исходного кода.
Особенно важно не размещать Bearer-ключ в клиентском JavaScript, если этот код отправляется браузеру пользователя. Всё, что попадает в браузер, потенциально доступно пользователю. Для приватного ключа безопаснее строить запрос через серверную часть приложения.
Также проверьте историю Git перед публикацией проекта. Если секрет уже однажды попал в коммит, простого удаления строки из текущей версии недостаточно: значение могло остаться в предыдущих коммитах. В такой ситуации ключ не следует считать безопасным только потому, что строку убрали из последнего файла.
В рабочем проекте удобно разделить конфигурацию на три значения: базовый URL API, ключ и параметры конкретной операции. Базовый URL можно оставить константой, а ключ читать из окружения. Это сохраняет один и тот же код между локальным запуском и сервером, меняя только конфигурацию.
Таким образом, схема первого подключения выглядит коротко: зарегистрироваться, войти в раздел API, получить ключ, сохранить его, проверить /services, при необходимости посмотреть /balance, затем отправить задачу через /generate и получить результат через /tasks/{id}. Если проект работает с файлами, перед генерацией добавляется /uploads, а для событийного получения результата можно использовать callback_url.
Частые вопросы
Нужна ли банковская карта, чтобы получить ключ?
Нет. При выпуске первого ключа на баланс начисляется 50 ₽ пробных средств. Оплата за запуск происходит отдельно, без абонентской платы и минимального платежа.
Где получить api ключ нейросети?
После входа в аккаунт ключ выдаётся в разделе API. Он показывается один раз, поэтому его нужно сразу скопировать и сохранить в безопасном месте.
Как проверить, что ключ работает?
Отправьте GET-запрос на /services с заголовком Authorization: Bearer <ключ>. Успешный ответ содержит список операций и их цены.
Можно ли использовать API нейросети без регистрации карты?
Да. Для выпуска первого ключа банковская карта не требуется, а на баланс при выпуске начисляется 50 ₽ пробных средств.
Что делать после получения ID задачи?
Используйте GET-запрос к /tasks/{id}, подставив полученный идентификатор. API вернёт состояние задачи и, когда она будет готова, результат. Вместо регулярного опроса можно передать callback_url и получить POST на свой endpoint после завершения.
Есть ли ограничение на количество запросов?
Да. На один ключ разрешено не более 60 запросов в минуту. Это ограничение нужно учитывать при частом запуске операций и при опросе статуса задач.
Если базовая проверка прошла, следующий шаг — перенести тот же запрос из терминала в код приложения и вынести ключ в переменную окружения. Документация и выпуск нового ключа доступны в разделе управления API.
