Как сгенерировать картинку с помощью нейросети по API
Как сгенерировать картинку с помощью нейросети из своего приложения: выберите модель изображений, передайте текст сцены в Images API и сохраните байты ответа. В Relay маршрут запроса: https://relay-llm.ru/v1/images/generations. Нужны API-ключ и серверный код. Готовый результат приходит в base64, поэтому печать JSON в консоль ещё не создаёт файл с картинкой.
Ниже пример для Node.js с fetch. Он подходит для первой генерации по тексту; загрузку исходной фотографии и редактирование изображения этот пример не выполняет.
Коротко
Выберите модель с протоколом
openai_imagesв каталоге.Сохраните
data[0].b64_jsonкак байты файла.Проверьте содержание и формат перед размещением на сайте.
Как сгенерировать картинку с помощью нейросети: подготовка
Сначала решите, что должен увидеть пользователь. Для статьи подойдёт иллюстрация рабочего места; для инструкции может понадобиться схема, где ошибки в подписях недопустимы. Если нужен точный интерфейс программы, используйте снимок экрана. Генерация по описанию может нарисовать правдоподобные, но несуществующие кнопки.
Откройте каталог моделей и проверьте карточку gpt-image-2. Идентификатор из примера есть в публичном каталоге, но доступность и цену перед рабочим запуском нужно сверить снова. Не подставляйте в model название текстовой модели.
Создайте ключ в кабинете. Для сайта вызывайте API из серверного обработчика: секрет не должен попадать в исходник страницы, сборку фронтенда или сетевой ответ посетителю. На время опыта достаточно локального Node.js-скрипта.
Как составить описание без противоречий
Опишите главный объект, расположение и фон. Затем добавьте ракурс, свет и запреты, если они влияют на результат. Пример: «Плоская иллюстрация стола с ноутбуком и закрытым блокнотом, вид сверху, белый фон, синие акценты, без текста».
Не смешивайте несколько задач. Просьба одновременно сделать логотип, рекламный баннер и схему создаёт результат, который трудно принять по чётким признакам. Для баннера сначала получите фон с местом под надпись, затем добавьте заголовок обычным редактором.
Перед запросом выпишите, что обязательно: ноутбук виден целиком, блокнот закрыт, букв нет. После генерации проверяйте именно этот список. Если не устроило расположение, меняйте расположение, сохраняя остальные условия. Иначе будет трудно понять причину улучшения или ухудшения.
Как сохранить результат из Node.js
Используйте среду Node.js, где доступны глобальный fetch и модуль node:fs/promises. Сохраните код в файл .mjs. В примере стоит вымышленный ключ; для рабочего приложения читайте секрет из серверного окружения.
const { writeFile } = await import('node:fs/promises')
const response = await fetch('https://relay-llm.ru/v1/images/generations', {
method: 'POST',
headers: {
Authorization: 'Bearer sk-demo-not-a-real-key',
'Content-Type': 'application/json',
},
body: JSON.stringify({
model: 'gpt-image-2',
prompt: 'Плоская иллюстрация стола с ноутбуком, вид сверху, без текста',
n: 1,
}),
})
if (!response.ok) {
throw new Error(`HTTP ${response.status}: ${await response.text()}`)
}
const result = await response.json()
const encoded = result.data?.[0]?.b64_json
if (typeof encoded !== 'string' || encoded.length === 0) {
throw new Error('В ответе нет изображения')
}
await writeFile('generated.image', Buffer.from(encoded, 'base64'))Файл содержит исходные байты. Определите формат по содержимому, например командой file generated.image, и назначьте подходящее расширение. Переименование файла не меняет кодировку изображения. Если вашему сайту нужен другой формат или размер, выполните отдельное преобразование после загрузки.
Как разбирать ошибки запроса
При 401 проверьте ключ. При 404 сравните model с каталогом. При 400 перечитайте поля в справочнике Images API: шлюз читает model и n, остальные параметры передаёт модели, поэтому произвольное значение size может не подойти.
При 402 посмотрите код отказа: insufficient_balance относится к доступным средствам, key_limit_exceeded к настройкам ключа. Пополнение не повышает лимит ключа. Для поддержки сохраните x-request-id, но удалите ключ из диагностических материалов.
Таймаут клиента не доказывает, что генерация остановилась. Проверьте историю запросов перед повтором: успешно полученное изображение может быть оплачено после разрыва соединения.
Как проверить качество и посчитать цену серии
Откройте файл и сравните его с критериями задания. Увеличьте области с надписями, руками и мелкими деталями. Посмотрите картинку в размере будущей публикации: хороший крупный рисунок может стать нечитаемым превью.
Оцените цену в каталоге или на странице цен. Затем разделите весь расход серии на число пригодных изображений. Если большая часть вариантов уходит в брак, сначала уточните описание и критерии, а затем увеличивайте число запросов.
Как сгенерировать картинку с помощью нейросети без кода?
Потребуется приложение с интерфейсом генерации. Это руководство показывает API-вызов для разработчика; один ключ сам по себе интерфейс не создаёт.
Можно ли вызвать Images API прямо из браузера?
Не размещайте секрет в браузере. Сделайте серверный обработчик, который отправит запрос и вернёт пользователю готовый результат.
Почему JSON есть, а картинка не открывается?
Сохраните декодированные байты b64_json, а не сам JSON и не строку base64. Затем проверьте формат файла.
Можно ли редактировать фотографию этим примером?
Нет. Пример передаёт только текст. Поддержку входных изображений и нужного сценария проверьте отдельно по документации модели и API.