Что даёт единый API нейросетей
API нейросетей на ГПТ Россия — это один REST-интерфейс сразу к генерации изображений, видео и озвучки: один ключ, оплата в рублях за вызов, без зарубежных карт и VPN. Базовый URL — https://api.gptrf.ru/api/public/v1, авторизация обычным Bearer-токеном. Первый работающий запрос реально уложить в десять минут — проверим по шагам.
Если только начинаете работать с внешними интерфейсами, загляните в короткий разбор, что такое API, — дальше всё будет привычным для любого REST.
Шаг 1. Получите ключ
Зарегистрируйтесь на gptrf.ru и откройте кабинет разработчика: раздел ключей находится в /dashboard/developer/keys. Нажмите «Создать ключ» — он имеет вид gptrf_... и показывается один раз, поэтому сразу сохраните его в менеджер секретов. Ключ передаётся в заголовке Authorization: Bearer <ключ> или X-API-Key.
Шаг 2. Первый запрос: картинка через curl
Сгенерируем изображение моделью Nano Banana — 8 ₽ за картинку:
curl -X POST https://api.gptrf.ru/api/public/v1/images/generate \
-H "Authorization: Bearer gptrf_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{"model": "nano-banana", "prompt": "уютная кофейня зимним вечером, тёплый свет, фотореализм"}'
В ответ придёт объект генерации с id. Генерация асинхронная, поэтому третьим шагом проверяем статус.
Шаг 3. Статус и результат
curl https://api.gptrf.ru/api/public/v1/creations/{id} \
-H "Authorization: Bearer gptrf_ваш_ключ"
Когда генерация завершится, в ответе будет ссылка на готовый файл. Чтобы не опрашивать статус в цикле, передайте в исходном запросе поле webhook_url — платформа сама пришлёт результат на ваш адрес. Для защиты от дублей при ретраях используйте заголовок X-Idempotency-Key: повторный запрос с тем же ключом не создаст вторую генерацию и не спишет деньги дважды.
Что ещё умеет API
| Эндпоинт | Задача |
|---|---|
images/generate | Генерация, редактирование по фото, inpaint по маске |
images/upscale | Апскейл изображения |
images/remove-background | Удаление фона |
video/generate | Видео по тексту и оживление фото |
audio/generate | Озвучка текста (TTS) |
audio/dialogue | Многоголосый диалог |
uploads | Загрузка файла, возвращает file_id |
models | Каталог доступных моделей с ценами |
Цены за вызов
Биллинг простой: у API отдельный кошелёк, деньги списываются за вызов до генерации, а при ошибке автоматически возвращаются. Ориентиры по картинкам: Z-Image — 1 ₽, GPT Image 1.5 — 6 ₽, Nano Banana и GPT Image 2 — 8 ₽, Seedream 4.5 — 9 ₽, Nano Banana Pro — 30 ₽ за изображение. Видео Seedance 2 — 20 ₽ за секунду, Veo 3.1 — 60 ₽ за 8 секунд, озвучка ElevenLabs Turbo v2.5 — 6 ₽ за 1000 знаков. Полные прайсы — на странице тарифов; учтите, что подписочные безлимиты на API-кошелёк не распространяются.
Дальше: документация и продакшен
Полное описание параметров, форматов ответов и кодов ошибок — в разделе для разработчиков и в документации на gptrf.ru/developers/docs. Для продакшена держите в голове три вещи: ключ храните только на сервере (не во фронтенде), на ретраях всегда используйте идемпотентность, а результат забирайте вебхуком вместо опроса статуса.
Попробовать модели можно за один вечер: регистрация даёт приветственный бонус 50 ₽ на основной баланс — его удобно потратить на пробные генерации на сайте или через CLI/MCP (они списывают именно с основного баланса). REST API работает с отдельного API-кошелька, поэтому для первых запросов пополните его на небольшую сумму — без VPN и с оплатой российской картой.
Частые вопросы
Чем этот API удобнее прямых интеграций с каждой нейросетью?
Один ключ и один формат запросов вместо пяти разных SDK, зарубежных карт и прокси. Модели меняются параметром model, оплата — в рублях с одного кошелька, документы для бухгалтерии — российские.
Что будет, если генерация упадёт с ошибкой?
Списание вернётся автоматически: биллинг работает по схеме «предоплата вызова + авто-возврат при ошибке». Со своей стороны добавьте ретраи с тем же X-Idempotency-Key, чтобы повтор не создал дубль.
Есть ли готовые SDK или обязательно писать запросы руками?
Достаточно любого HTTP-клиента — интерфейс это обычный REST с JSON. Кроме API есть CLI-утилита и MCP-сервер для ИИ-агентов; ссылки на все способы подключения собраны в разделе для разработчиков.
