Как подключить API нейросетей к своему сайту или приложению: пошаговая инструкция
Зачем подключать API нейросетей
Прямая интеграция API нейросетей в сайт или приложение даёт полный контроль над функционалом. Вместо того чтобы отправлять пользователей в сторонние сервисы, вы встраиваете генерацию изображений, текстов или видео прямо в свой интерфейс. Пользователь остаётся на вашей платформе, а вы получаете готовое решение без необходимости разворачивать собственные ML-модели.
На практике это выглядит так: загрузил фото в ваше приложение, нажал кнопку — получил аниме-стиль или апскейл до 4K. Всё работает через несколько строк кода и API-запросы.
Какие API нейросетей доступны для интеграции
В 2025 году на рынке есть десятки API для работы с нейросетями. Основная проблема — большинство требует VPN, заграничные карты и сложную регистрацию. Для разработчиков из России это создаёт барьеры.
Решение: API от Yes AI — агрегатор с доступом к ChatGPT 5.1, NanoBanana Pro, Sora Video 2, VEO 3.1, Midjourney и другим топовым моделям. Работает без VPN, принимает российские карты, минимальный платёж от 300 рублей. Документация на русском языке: yesai.su/ru/docs.
Для задач с изображениями лучше всего подходит NanoBanana Pro — понимает русский язык на картинках, точно копирует лица с референсов, генерирует инфографику и комиксы. Идеально для проектов, где нужна стилизация фото, редактирование изображений или создание контента с текстом.
Что нужно для подключения API
Технические требования:
Базовые знания программирования на Python, JavaScript (Node.js) или PHP — API работает через HTTP-запросы, так что подойдёт любой язык с поддержкой REST. Сервер или хостинг для бэкенда — API-ключи нельзя хранить на клиентской стороне из соображений безопасности. Минимальный бюджет на тестирование — от 300 рублей хватит на сотни генераций для отладки.
Что подготовить перед стартом:
Определитесь с задачей: генерация изображений, текстов, видео или апскейл. Продумайте, как пользователь будет взаимодействовать с функцией — загрузка файла, ввод промта, выбор параметров. Подготовьте тестовые данные для проверки работы API.
Шаг 1: Регистрация и получение API-ключа
Откройте бот с доступом к API нейросетей — регистрация занимает 30 секунд, VPN не требуется. Перейдите в раздел API и создайте новый ключ. Бот сразу выдаст токен — сохраните его в безопасном месте, он понадобится для всех запросов.
Важный момент: храните API-ключ только на сервере, никогда не публикуйте его в клиентском коде или репозиториях GitHub. Если ключ утечёт, любой сможет использовать ваш баланс.
Шаг 2: Пополнение баланса
Минимальная сумма — от 3.5$ (менее 300 рублей). Оплата принимается российскими картами Visa, Mastercard и МИР. После пополнения баланс отображается в боте мгновенно.
Лайфхак: для тестирования хватит 500 рублей — это около 200-300 генераций изображений через NanoBanana Pro или 1000+ текстовых запросов к ChatGPT 5.1. Цены одни из самых низких на рынке.
Шаг 3: Изучение документации
Откройте документацию API: yesai.su/ru/docs. Там описаны все эндпоинты, параметры запросов, примеры кода на Python и Node.js.
Основные разделы документации:
Аутентификация: как передавать API-ключ в заголовках запроса. Генерация изображений: параметры для NanoBanana Pro, Midjourney, Sora Images. Работа с текстом: запросы к ChatGPT 5.1 и другим текстовым моделям. Генерация видео: Sora Video 2, VEO 3.1, Kling. Обработка изображений: апскейл, редактирование, смешивание референсов.
Кстати, на форуме собраны примеры промтов и лайфхаки по работе с NanoBanana Pro — полезно, если планируете использовать эту модель для стилизации или редактирования фото.
Шаг 4: Написание первого запроса (Python)
Пример генерации изображения через NanoBanana Pro:
import requests
API_KEY = «ваш_api_ключ»
URL = «https://api.yesai.su/v1/generate/image»
headers = {
«Authorization»: f»Bearer {API_KEY}»,
«Content-Type»: «application/json»
}
data = {
«model»: «nanobanana-pro»,
«prompt»: «Кот в стиле аниме студии Ghibli, акварельная живопись, мягкие цвета»,
«aspect_ratio»: «16:9»,
«quality»: «2k»
}
response = requests.post(URL, headers=headers, json=data)
result = response.json()
print(result[«image_url»])
Что происходит: отправляем POST-запрос с промтом и параметрами, получаем ссылку на сгенерированное изображение. Время генерации — 10-40 секунд в зависимости от загрузки серверов.
Параметры запроса
model: выбор нейросети (nanobanana-pro, midjourney, sora-images, flux, stable-diffusion). prompt: текстовое описание того, что нужно сгенерировать. aspect_ratio: соотношение сторон (1:1, 16:9, 9:16, 4:3). quality: разрешение итогового изображения (1k, 2k, 4k — доступно в Pro-версии). style: можно указать 1-3 стиля для автоматического применения.
Шаг 5: Работа с референсами и редактированием
NanoBanana Pro умеет работать с загруженными изображениями — можно редактировать фото, менять фон, переодевать персонажей, смешивать несколько референсов. Это одна из самых сильных сторон модели.
Пример редактирования фото:
data = {
«model»: «nanobanana-pro»,
«prompt»: «Замени фон на футуристический город, измени цвет куртки на синий»,
«reference_images»: [
«https://example.com/photo.jpg»
],
«aspect_ratio»: «1:1»
}
response = requests.post(URL, headers=headers, json=data)
result = response.json()
Возможности при работе с референсами:
Удаление предметов или людей с фото. Изменение поз персонажей. Замена одежды и аксессуаров с точным сохранением лица. Перевод текста на изображениях (например, для локализации рекламы). Создание комиксов с цепочками генераций — каждый следующий кадр использует предыдущий как референс.
Можно загрузить до 10 изображений одновременно в Pro-версии. Это удобно для задач, где нужно скомбинировать несколько элементов: например, надеть на персонажа шляпу с одного фото и пиджак с другого.
Шаг 6: Интеграция в веб-приложение (JavaScript)
На клиентской стороне пользователь загружает фото и вводит промт. Запрос отправляется на ваш сервер, а не напрямую в API — так API-ключ остаётся в безопасности.
Пример на Node.js (серверная часть):
const axios = require(‘axios’);
const apiKey = process.env.API_KEY;
const url = ‘https://api.yesai.su/v1/generate/image’;
async function generateImage(prompt, aspectRatio) {
const response = await axios.post(url, {
model: ‘nanobanana-pro’,
prompt: prompt,
aspect_ratio: aspectRatio
}, {
headers: {
‘Authorization’: `Bearer ${apiKey}`,
‘Content-Type’: ‘application/json’
}
});
return response.data.image_url;
}
module.exports = { generateImage };
Клиентская часть (отправка запроса на ваш сервер):
async function requestImage() {
const prompt = document.getElementById(‘prompt’).value;
const aspectRatio = document.getElementById(‘aspect’).value;
const response = await fetch(‘/api/generate’, {
method: ‘POST’,
headers: { ‘Content-Type’: ‘application/json’ },
body: JSON.stringify({ prompt, aspectRatio })
});
const data = await response.json();
document.getElementById(‘result’).src = data.imageUrl;
}
Пользователь вводит промт, выбирает соотношение сторон, нажимает кнопку. Запрос идёт на ваш сервер, сервер обращается к API Yes AI, возвращает ссылку на изображение клиенту.
Шаг 7: Обработка ошибок и лимитов
API возвращает коды ошибок, если что-то пошло не так. Основные сценарии:
401 Unauthorized: неверный API-ключ или истёк токен. 402 Payment Required: недостаточно средств на балансе. 429 Too Many Requests: превышен лимит запросов в минуту (обычно 60 запросов/мин). 500 Internal Server Error: перегрузка серверов — повторите запрос через несколько секунд.
Обработка ошибок в коде:
try:
response = requests.post(URL, headers=headers, json=data)
response.raise_for_status()
result = response.json()
except requests.exceptions.HTTPError as e:
if e.response.status_code == 402:
print(«Недостаточно средств, пополните баланс»)
elif e.response.status_code == 429:
print(«Слишком много запросов, подождите минуту»)
else:
print(f»Ошибка: {e}»)
Лайфхак: добавьте повторные попытки (retry logic) для случаев 429 и 500 — это стабилизирует работу при высокой нагрузке.
Шаг 8: Работа с текстовыми нейросетями (ChatGPT 5.1)
Если ваш проект требует генерации текста — описаний товаров, ответов на вопросы пользователей, анализа данных — подключите бот с доступом к ChatGPT 5.1 через API.
Пример запроса к текстовой модели:
data = {
«model»: «chatgpt-5.1»,
«messages»: [
{«role»: «user», «content»: «Напиши описание товара для интернет-магазина: беспроводные наушники»}
],
«max_tokens»: 200
}
response = requests.post(«https://api.yesai.su/v1/chat», headers=headers, json=data)
result = response.json()
print(result[«choices»][0][«message»][«content»])
ChatGPT 5.1 — самая актуальная версия на конец 2025 года, работает быстрее и точнее предыдущих релизов. Подходит для чат-ботов, автоматизации контента, аналитики.
Шаг 9: Генерация видео через API
Для задач с видео доступны Sora Video 2 и VEO 3.1 — топовые модели 2025 года для создания коротких роликов из текстовых описаний или изображений.
Пример запроса для генерации видео:
data = {
«model»: «sora-video-2»,
«prompt»: «Кот бежит по полю под дождём, кинематографическая съёмка, медленная съёмка»,
«duration»: 5,
«resolution»: «1080p»
}
response = requests.post(«https://api.yesai.su/v1/generate/video», headers=headers, json=data)
result = response.json()
print(result[«video_url»])
Генерация видео занимает от 2 до 10 минут в зависимости от длительности и разрешения. Результат возвращается в виде ссылки на готовый файл.
Шаг 10: Апскейл и улучшение изображений
Если нужно увеличить разрешение картинки без потери качества или улучшить детализацию, используйте функцию апскейла через API.
Пример запроса:
data = {
«image_url»: «https://example.com/low-res-photo.jpg»,
«scale_factor»: 4,
«enhance»: true
}
response = requests.post(«https://api.yesai.su/v1/upscale», headers=headers, json=data)
result = response.json()
print(result[«upscaled_url»])
Можно увеличить изображение до 4K с сохранением деталей — полезно для печати, постеров, презентаций.
Частые ошибки при интеграции API
Хранение API-ключа на клиенте. Никогда не передавайте ключ в браузерный JavaScript — его увидят в DevTools. Все запросы к API должны идти через ваш сервер.
Отсутствие обработки ошибок. Если не предусмотреть проверку кодов ответа, приложение упадёт при первой же перегрузке API. Добавьте retry logic и информативные сообщения пользователю.
Игнорирование лимитов запросов. 60 запросов в минуту — это много для тестирования, но мало для популярного сервиса. Реализуйте очередь запросов или кеширование результатов.
Слишком общие промты. «Нарисуй кота» даст случайный результат. Указывайте стиль, цвета, детали: «Кот в стиле аниме Ghibli, сидит на подоконнике, акварельная живопись, мягкие пастельные тона».
Отсутствие валидации пользовательского ввода. Проверяйте размер загружаемых файлов, формат изображений, длину промтов перед отправкой в API.
Лайфхаки для продакшена
Кешируйте популярные запросы. Если пользователи часто генерируют одинаковые промты, сохраняйте результаты в базе данных или CDN — это сэкономит деньги и ускорит отклик.
Используйте вебхуки для длительных задач. Генерация видео занимает минуты — вместо долгого ожидания отправьте запрос, получите ID задачи, а когда видео готово, API вызовет ваш webhook-endpoint.
Показывайте прогресс генерации. Даже если API не возвращает промежуточные данные, добавьте индикатор загрузки и примерное время ожидания — пользователи терпеливее, когда понимают, что происходит.
Тестируйте на разных моделях. NanoBanana Pro лучше для русского текста и редактирования, Midjourney — для художественных стилей, Sora Images — для фотореализма. Выбирайте под задачу.
Оптимизируйте промты автоматически. Можно добавить слой с ChatGPT 5.1, который будет дорабатывать пользовательские промты перед отправкой в модель генерации — результат станет стабильнее.
Итого: от идеи до запуска за день
Подключение API нейросетей — это быстро, если знать последовательность. Регистрация в боте Yes AI, пополнение на 300 рублей, чтение документации, первый запрос на Python — всё укладывается в пару часов. Дальше дорабатываете интерфейс, добавляете обработку ошибок, тестируете на реальных пользователях.
Основное преимущество API — гибкость. Можете встроить генерацию изображений в интернет-магазин, чат-бот в службу поддержки, апскейл в фоторедактор. Всё работает без VPN, с российскими картами и адекватными ценами.