Три двери к API нейросетей: короткий ответ
Если вы встраиваете генерацию в свой продукт — берите REST API нейросети: ключ, предсказуемый биллинг за вызов, вебхуки. Если автоматизируете задачи скриптами или работаете из терминала — CLI. Если генерировать должен ИИ-агент (Claude Code, Cursor, Claude Desktop) — подключайте MCP-сервер, там вообще не нужны ключи. Все три двери ведут к одному каталогу моделей ГПТ Россия: картинки, видео, озвучка, апскейл.
Сравнение: биллинг, авторизация, сценарии
| Критерий | REST API | CLI (@gptrf/cli) | MCP-сервер |
|---|---|---|---|
| Авторизация | Ключ gptrf_... | gptrf auth login через браузер | OAuth-вход в аккаунт |
| Списание | Отдельный API-кошелёк | Основной баланс | Основной баланс |
| Скидки подписки | Не действуют | Действуют | Действуют |
| Кому подходит | Продукты, бэкенды | Скрипты, пайплайны, терминал | ИИ-агенты и ассистенты |
Ключевое различие — биллинг. У API отдельный кошелёк с оплатой за вызов, pre-charge и автоматическим возвратом при ошибке генерации: удобно, когда расходы продукта нужно учитывать отдельно от личных. CLI и MCP списывают с основного баланса, и скидки тарифа применяются — до 20% в зависимости от плана.
REST API: для продакшена
Публичный API живёт на https://api.gptrf.ru/api/public/v1. Эндпоинты: генерация и редактирование изображений (включая inpaint по маске), апскейл, удаление фона, видео, TTS и многоголосые диалоги, загрузка файлов, статус задач, каталог моделей. Ключ создаётся в кабинете, показывается один раз, передаётся в Authorization: Bearer или X-API-Key.
curl -X POST https://api.gptrf.ru/api/public/v1/images/generate \
-H "Authorization: Bearer gptrf_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{"prompt": "минималистичный логотип кофейни", "model": "z-image"}'
Продакшен-детали на месте: идемпотентность через заголовок X-Idempotency-Key (повторный запрос не спишет деньги дважды), поле webhook_url в запросе — и результат прилетит вам сам, без поллинга. Что такое ключи, эндпоинты и коды ответов — коротко разобрано в глоссарии по API, а полная документация и создание ключа — на странице для разработчиков.
CLI: генерация одной командой
Утилита ставится из npm (нужен Node 20+):
npm install -g @gptrf/cli
gptrf auth login
gptrf image "неоновый город под дождём" -m nano-banana
Ключ не нужен — вход через браузер. Дальше gptrf video, gptrf audio, gptrf upscale, gptrf remove-bg встраиваются в любой шелл-скрипт или CI-пайплайн: сгенерировать обложки для пачки статей, озвучить список текстов, прогнать папку картинок через апскейл — всё это циклы в три строки.
MCP: когда генерирует сам агент
MCP-сервер https://mcp.gptrf.ru/mcp отдаёт агенту 11 инструментов: генерация изображений, видео и аудио, апскейл, удаление фона, загрузка файлов, статусы задач, баланс, список моделей. Подключение к Claude Code — одна команда:
claude mcp add --transport http gptrf https://mcp.gptrf.ru/mcp
Дальше агент сам решает, когда генерировать: «сделай иллюстрации к README» — и Claude Code выберет модель, сгенерирует и сохранит файлы. Работает также в Claude.ai и Claude Desktop (Settings → Connectors), Cursor и Codex. Как термин MCP устроен изнутри — см. глоссарий по MCP, а все способы подключения агентов собраны на странице /connect.
С чего начать
Заведите аккаунт — новичку начисляется 50 ₽, этого хватает на десятки тестовых генераций (картинка стоит от 1 ₽). Попробуйте сценарий в CLI или MCP на welcome-бонусе, а когда решите встраивать в продукт — создайте API-ключ и пополните API-кошелёк. Оплата в рублях российской картой, инфраструктура в России.
Частые вопросы
Чем MCP отличается от обычного API?
API вызываете вы своим кодом, а MCP-инструменты вызывает ИИ-агент сам, когда решает, что задача этого требует. MCP не требует ключей — авторизация через OAuth-вход в аккаунт. Для продукта берите API, для работы с Claude Code или Cursor — MCP.
Что будет, если генерация упадёт с ошибкой?
Биллинг устроен по схеме pre-charge: деньги резервируются перед генерацией и автоматически возвращаются при ошибке. Платите только за успешные результаты — это работает во всех трёх каналах.
Действуют ли подписочные лимиты в API?
Нет, подписочные безлимиты в API не действуют — у API отдельный кошелёк с оплатой за вызов. А вот CLI и MCP списывают с основного баланса, и скидка вашего тарифа (до 20%) применяется к каждой генерации.
