API генерации изображений в России

Какие нейросети генерируют изображения по API

Изображения по API рисуют 4 модели — Nano Banana 2, Nano Banana Pro, GPT Image 2 и Grok Imagine Image 2.0. Сделаны они Google, OpenAI и xAI, и каждая стоит в каталоге отдельной записью: свой идентификатор для поля model, свой набор полей запроса и своя таблица цен.

Выбирать между ними по виду работы не приходится: обе работы делают Nano Banana 2, Nano Banana Pro и GPT Image 2, а Grok Imagine Image 2.0 создаёт картинку с нуля и присланную не берёт. Расходятся модели в другом — в том, сколько текста уходит в описание, сколько картинок принимает вход и во что обходится готовое изображение.

Описание модель получает текстом, и предел длины у этого поля свой: до 20 000 знаков у Nano Banana 2 и GPT Image 2, до 10 000 знаков у Nano Banana Pro, до 5 000 знаков у Grok Imagine Image 2.0. Описание длиннее предела шлюз не пропустит — такой запрос до поставщика не доходит.

Имя из второго столбца — это всё, что меняется в запросе при переходе с одной модели на другую. Цена в последнем столбце самая низкая по модели: она относится к простому разрешению, а высокое стоит дороже.

Что можно получить: генерация по описанию и правка присланной картинки

Работ здесь две. Первая — новое изображение по тексту: в запрос уходит описание, а в ответ приходит ссылка на готовый файл; сам ответ разобран в разделе «Формат ответа». Вторая — правка присланного: рядом с описанием в запросе лежат ссылки на ваши картинки, и модель возвращает их переделанными.

Правка отличается от генерации не одними этими ссылками. Вызывается она у моделей по-разному: у GPT Image 2 под правку заведён отдельный идентификатор, и запрос без ссылок на исходные картинки шлюз отклоняет сам; у Nano Banana 2 и Nano Banana Pro идентификатор остаётся прежним, а правкой запрос делают сами ссылки. Сколько исходных картинок берёт один запрос, у каждой модели тоже своё: Nano Banana Pro — до 8, Nano Banana 2 — до 14, GPT Image 2 — до 16.

Размер картинки и форма кадра задаются отдельными полями. Разрешение выбирается из готового списка, и набор у них общий — 1K, 2K и 4K. А у Grok Imagine Image 2.0 размер задаёт форма кадра — от 1008 × 1792 у вертикали до 1792 × 1008 у широкого кадра, около двух мегапикселей в любой форме. Форм кадра больше, и наборы у моделей разные: у Grok Imagine Image 2.0 их 5, у GPT Image 2 — 15. У Nano Banana 2, Nano Banana Pro и GPT Image 2 есть ещё значение auto — им форма кадра не задаётся вовсе.

1. Ссылка. Готовят адрес исходного файла: чужой или свой, полученный загрузкой на наш адрес.
2. Описание. Пишут, что именно поменять, и называют границу правки словами, а не одной размеченной областью.
3. Поля. Рядом с описанием ставят ссылки, а размер и форму кадра задают своими полями запроса.
4. Задача. Дальше всё как при рисовании с чистого листа: задача ставится, её состояние опрашивают, готовое забирают ссылкой.

• Размер готового файла задаётся полем запроса и от размера присланной картинки не наследуется.
• Присутствие исходной картинки само по себе меняет работу модели: правка и рисование с чистого листа идут по-разному.
• Названная в описании область правки держится нестрого, и границу приходится повторять словами.
• После правки картинка возвращается мягче исходника — это свойство работы, а не сбой.
• Длинная цепочка правок упирается в предел: чище начать заново, отправив последний удачный файл на вход.

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

Сколько стоит генерация изображения по API

Готовая картинка обходится от 3,5 ₽ до 21,5 ₽, и место в этой вилке определяет выбранное разрешение. Счёт идёт за генерацию: платят за вызов, который вернул изображение, а длина описания и число присланных картинок на цену не влияют.

Таблица цен у каждой модели своя, и строк в ней от 1 до 3. Строк бывает меньше, чем разрешений: у Nano Banana Pro строка «1/2K» стоит сразу за 2 разрешения. Цена «от» по всем моделям сразу стоит в таблице выше.

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

Как передать свою картинку в запрос

Исходная картинка передаётся ссылкой, а не самим файлом: в теле запроса ей места нет. Проверяет ссылку наш шлюз, до обращения к поставщику, поэтому негодный адрес виден сразу и кредитов не стоит.

• Ссылка принимается полным адресом на http или https, длиной не больше 2 048 символов.
• Адрес должен открываться снаружи: имена без точки и адреса внутри сети шлюз отклоняет сам.
• Ни имени с паролем перед адресом, ни своего порта в ссылке быть не должно.
• Файл с диска сначала загружают на https://api.gen202.com/api/v1/files/upload — полем формы file, размером до 8 МиБ.
• Загрузка принимает JPG, PNG, WEBP и PDF, а в ответ отдаёт готовую ссылку.

Полученную ссылку ставят в поле модели там же, где стояла бы чужая, и дальше запрос ничем не отличается от обычного. Разбор загрузки с примером запроса лежит в разделе «Загрузка своих файлов».

Что приходит в ответ и сколько живёт ссылка

Через API картинка по запросу приходит ссылкой на файл, а не самим файлом. В чате браузера изображение появляется на экране, а здесь программа получает адрес и скачивает его сама. Первый запрос возвращает только номер задачи, второй — её состояние, и в состоянии success рядом со ссылками стоит creditsConsumed: столько списано.

Поле resultJson приходит строкой, а не объектом, и разбирать его нужно вторым разбором JSON. Ссылка на готовый файл живёт 14 дней — столько результат хранит поставщик. Поэтому картинку стоит забрать к себе сразу, а не держать в своей базе один её адрес.

Отказ приходит в том же конверте, что и успешный ответ, только с пустым полем data. Имя модели не из каталога, лишнее поле или значение вне её перечня шлюз отклоняет до обращения к поставщику, и кредитов такой запрос не стоит. Дольше 15 минут задача не идёт: по истечении срока она закрывается неудачей, а удержание возвращается целиком.

Спрашивать состояние стоит с шагом в 3 секунды: опрос пропускается до 300 раз в минуту на ключ, и сам он тоже расходует лимит. Успешный ответ на постановку — ещё не картинка, и читать в нём надо поле состояния, а не поле со ссылками. Один оборвавшийся опрос задачу не теряет: тем же номером её состояние спрашивают снова.

Держать у себя ссылку вместо самого файла — это поломка, которая проявится позже. Просроченный адрес отвечает отказом по проверке доступа, а не сообщением о пропаже файла.

Есть ли бесплатное API картинки

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

Остальное открывает вход: новому счёту начисляется 50 кредитов, и ими оплачиваются картинки в любом разрешении. Модель, форму кадра и размер вы задаёте здесь уже полями запроса.

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

API картинок из России: без VPN и с оплатой рублями

VPN здесь не нужен. Ваша программа обращается по нашему адресу, а не к самим Google, OpenAI и xAI: дальше запрос поставщику отправляем мы.

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

API ключ для создания картинок один на весь каталог. Выпускается он в кабинете сразу после входа на сайт, и заводить второй ради другой картиночной модели не надо. Учётной записи у Google, OpenAI и xAI при этом не нужно: расчёты с поставщиками ведём мы.