Genius-bot · 12 минут чтения
Если вам нужен api генерации изображений бесплатно для первичной проверки, главный вопрос не в том, сколько картинок получится создать, а в том, что именно удастся проверить за выданный пробный баланс. При первом выпуске ключа на баланс начисляется 50 ₽, а одна генерация картинки по описанию стоит 9 ₽, поэтому бюджет позволяет провести несколько осмысленных тестов вместо серии случайных запросов.
В этой статье — практический порядок проверки: сначала дешёвые запросы, затем более дорогие операции, после каждого шага фиксируем результат. Такой подход позволяет использовать пробный баланс api как небольшой тестовый стенд: проверить следование промту, работу с исходным изображением, устойчивость результата и понять, за какие операции действительно стоит платить дальше. Получить ключ и открыть раздел API можно после входа в аккаунт; ключ показывается один раз.
Ниже используются пять тестов с готовыми промтами. Они специально подобраны так, чтобы каждый следующий тест проверял отдельное свойство, а деньги не уходили на повторение одного и того же запроса без понятной причины.
Что именно нужно проверить до оплаты
До пополнения баланса стоит ответить на четыре практических вопроса. Во-первых, насколько точно генератор выполняет текстовое описание. Во-вторых, умеет ли операция редактирования сохранять нужные элементы исходного изображения. В-третьих, насколько предсказуем результат при повторном запуске похожего запроса. В-четвёртых, какие операции укладываются в ваш бюджет с учётом цены одного запуска.
Для доступа используется заголовок Authorization: Bearer <ключ>. Адрес API имеет вид https://genius-bot.ru/wp-json/genius/v1, а для генерации используется маршрут POST /generate. Список доступных операций и их цен можно получить через GET /services, остаток баланса — через GET /balance.
Перед тестами удобно запросить баланс и список операций. Это особенно важно, если вы проверяете не только обычную генерацию, но и редактирование или увеличение качества: цена запуска отличается, и план проверки лучше составить до отправки первого дорогого запроса.
curl -X GET "https://genius-bot.ru/wp-json/genius/v1/balance" \
-H "Authorization: Bearer YOUR_API_KEY"Для каждой задачи также есть маршрут GET /tasks/{id}, через который можно узнать состояние и результат. Если приложение работает асинхронно и не хочется постоянно опрашивать этот маршрут, при запуске можно передать параметр callback_url: после готовности задачи туда приходит POST.
Ещё одна деталь, которую стоит учитывать при автоматизированной проверке, — ограничение частоты. На один ключ допускается не более 60 запросов в минуту. Для ручного тестирования из пяти операций это ограничение практически не влияет на порядок работы, но при написании скрипта повторных прогонов его нужно учитывать.
Пять тестов, которые показывают качество
Пять тестов лучше выполнять не как пять попыток получить красивую картинку, а как пять проверок разных свойств. Для чистоты эксперимента сохраняйте текст промта без изменений, если задача предполагает повтор, и записывайте цену каждого запуска.
| Тест | Что проверяет | Операция | Цена запуска |
|---|---|---|---|
| 1. Сцена | Следование подробному описанию | image | 9 ₽ |
| 2. Композиция | Количество объектов и пространственные отношения | image | 9 ₽ |
| 3. Редактирование | Изменение заданной детали исходного изображения | image-edit | 35 ₽ |
| 4. Повтор | Стабильность результата при близких запросах | image | 9 ₽ |
| 5. Увеличение | Поведение операции повышения качества | upscale | 50 ₽ |
Тест 1. Подробная сцена. Начните с обычной генерации по описанию. Промт: «Фотография небольшого деревянного стола у окна, на столе лежат открытая книга с белыми страницами, керамическая кружка и зелёное яблоко; слева от окна стоит высокий комнатный цветок; мягкий утренний свет, вид сбоку, нейтральные натуральные цвета, без людей, без текста и логотипов».
Здесь не нужно оценивать картинку только по принципу «нравится — не нравится». Отметьте, присутствуют ли все перечисленные объекты, соблюдается ли их расположение, есть ли окно и цветок именно в заданных местах, нет ли случайных надписей. Один запуск стоит 9 ₽, поэтому это дешёвый способ получить первую точку отсчёта.
Тест 2. Количество и отношения между объектами. Второй промт: «Минималистичная предметная сцена: три красных яблока лежат в ряд на светлой деревянной поверхности, за ними находится одна синяя керамическая чашка, справа от чашки стоит маленькая стеклянная ваза с двумя белыми цветами; вид спереди, равномерный мягкий свет, без людей, без текста».
Этот запрос нужен не ради сюжета, а ради конкретных ограничений. Проверьте количество яблок, чашек, ваз и цветов, а также относительное положение предметов. Если модель добавляет или теряет объекты, это стоит записать отдельно: такая ошибка важнее субъективной оценки цветовой гаммы.
Тест 3. Редактирование исходного изображения. Здесь уже нужен файл, поэтому сначала используется POST /uploads, который загружает файл и возвращает ссылку. Затем эту ссылку можно использовать в операции редактирования. Для проверки возьмите простую фотографию предмета без сложного фона и попросите изменить только одну заметную деталь.
Готовый промт для редактирования: «Измени только цвет кружки на матовый тёмно-синий. Сохрани форму кружки, положение кружки, стол, фон, освещение и все остальные предметы без изменений». Такой запрос удобнее для оценки, чем просьба полностью преобразовать изображение: область изменений заранее понятна.
Цена операции image-edit составляет 35 ₽. После результата сравните исходник и новую версию по четырём пунктам: изменилась ли нужная деталь, сохранился ли объект, не появились ли лишние изменения и не нарушились ли края или фон вокруг объекта. Если результат не соответствует задаче, не стоит сразу отправлять три новых варианта: сначала зафиксируйте характер ошибки.
Тест 4. Повтор близкого запроса. Возьмите первый промт и выполните его ещё раз без изменения текста. Каждый запуск image стоит 9 ₽, поэтому два результата можно получить за небольшую часть пробного бюджета. Здесь проверяется не идентичность двух картинок, а повторяемость соблюдения условий.
Сравнивайте не художественные детали, а обязательные элементы. Если в первом результате было три яблока и одна чашка, а во втором количество объектов изменилось, это фиксируется как проблема выполнения условия. Если обязательные элементы сохранены, а композиция и детали отличаются, это уже другой тип поведения и его стоит записать отдельно.
Тест 5. Увеличение качества. Последним оставьте upscale, потому что один запуск стоит 50 ₽. Для него используйте изображение, на котором уже видны мелкие детали: текстуру ткани, тонкие линии предметов, волосы или мелкие элементы интерьера. Задача теста — не получить новую композицию, а сравнить исходник и результат операции повышения качества.
Проверяйте мелкие детали на одинаковом участке изображения. Смотрите, стали ли края визуально аккуратнее, появились ли новые артефакты и не изменилась ли сама сцена. Даже один такой прогон имеет смысл делать после дешёвых тестов: если базовая генерация не подходит по качеству, расходовать 50 ₽ на дополнительную операцию может быть преждевременно.
Порядок проверки: от дешёвого к дорогому
Порядок здесь определяет расход баланса. Сначала выполняются два теста image по 9 ₽, затем повтор одного из них ещё за 9 ₽, после этого — редактирование за 35 ₽ и только затем увеличение качества за 50 ₽. Стоимость пяти обязательных запусков из описанного плана составляет 112 ₽, поэтому полный набор не помещается в стартовые 50 ₽.
Это не означает, что нужно сразу пополнять баланс. Стартовые 50 ₽ позволяют провести первые четыре дешёвых запуска в разных комбинациях. Например, два базовых теста, один повтор и один тест редактирования обойдутся в 62 ₽, поэтому для такого варианта уже понадобится дополнительный баланс.
Если строго держаться стартовых 50 ₽, можно начать с двух генераций по 9 ₽, повторной генерации за 9 ₽ и оставить 23 ₽ неиспользованными. Такой резерв полезнее, чем тратить остаток на ещё один случайный сюжет: после первых результатов можно решить, какой тест действительно требует повтора.
Когда вы переходите к платной проверке, ориентируйтесь на цену операции из списка сервисов. Актуальные значения можно получить через GET /services; в справочных ценах для этого плана image стоит 9 ₽, image-edit — 35 ₽, а upscale — 50 ₽ за запуск.
import requests
BASE_URL = "https://genius-bot.ru/wp-json/genius/v1"
API_KEY = "YOUR_API_KEY"
headers = {
"Authorization": f"Bearer {API_KEY}"
}
response = requests.get(
f"{BASE_URL}/balance",
headers=headers,
timeout=30
)
response.raise_for_status()
print(response.json())Этот пример показывает именно проверку остатка перед серией тестов. Для запуска операции используется POST /generate, а полученный идентификатор задачи можно затем проверять через GET /tasks/{id}. Если задача готовится дольше, чем длится ваш HTTP-запрос, состояние лучше получать отдельными запросами или использовать callback_url.
Как фиксировать результаты сравнения
Самый простой вариант — таблица из одной строки на запуск. Не записывайте только итоговую оценку вроде «хорошо»: она плохо помогает при повторной проверке. Лучше разделить наблюдения на несколько измеримых полей.
| Поле | Что записывать |
|---|---|
| № запуска | Порядковый номер |
| Операция | image, image-edit или upscale |
| Цена | Стоимость конкретного запуска |
| Промт | Точный текст без пересказа |
| Условия выполнены | Да, частично или нет |
| Ошибки | Какие именно элементы выполнены неправильно |
| Решение | Повторить, изменить промт или перейти к следующему тесту |
Для первого теста полезно считать выполненные условия. В нашем промте их можно разделить на наличие стола, окна, книги, кружки, яблока, цветка, заданного положения цветка и отсутствия текста. Тогда результат можно описать, например, как «7 из 8 условий выполнены», а не просто «картинка хорошая».
Для редактирования используйте другой принцип. Отдельно фиксируйте, что должно было измениться, и отдельно — что должно было остаться прежним. Это позволяет отличить точечное редактирование от результата, где нужная деталь действительно изменилась, но вместе с ней поменялся фон.
При повторных генерациях не меняйте промт только потому, что первый результат оказался неудачным. Сначала сохраните исходный запрос и результат, затем отдельно проведите вариант с изменённым промтом. Иначе вы не поймёте, что повлияло на итог: повторный запуск или новая формулировка.
Сколько денег оставить на повторы
Резерв на повторы стоит планировать до начала тестирования. Если весь баланс уходит на первые пять разных операций, после обнаружения ошибки не останется денег на проверку гипотезы. Для стартовой проверки разумно считать резерв отдельной статьёй расходов, а не случайным остатком.
При стартовых 50 ₽ можно построить минимальный цикл вокруг операции image: четыре запуска по 9 ₽ потребуют 36 ₽, и 14 ₽ останутся на один дополнительный запуск той же операции. Это уже позволяет сравнить первоначальный промт с повтором и ещё раз проверить изменённую формулировку.
Если главная задача — проверить редактирование, один запуск image-edit за 35 ₽ оставляет 15 ₽. Их достаточно для одного запуска image за 9 ₽ и ещё 6 ₽ останутся неиспользованными. Если же хочется проверить upscale, одного стартового баланса 50 ₽ на эту операцию недостаточно: её запуск стоит 50 ₽ и не оставляет места для сравнения.
Поэтому для тестирования api генерации изображений бесплатно полезно заранее определить минимум, который даст ответ на ваш вопрос. Если нужен только тест текстовой генерации, не обязательно включать дорогие операции. Если критично редактирование исходников, лучше сохранить средства именно под image-edit, а не расходовать их на десять похожих сюжетов.
В более широком наборе API есть и другие операции, но для этого плана они не нужны. Например, «Оживить фото» стоит 25 ₽, «Видео по описанию» — 119 ₽, «Создать музыку» — 59 ₽, а «Говорящий аватар» — 120 ₽ за запуск. Эти цены показывают, почему при ограниченном пробном балансе тесты лучше выбирать по вопросу, который нужно проверить, а не по принципу «попробовать всё».
Решение: подходит сервис или нет
Решение стоит принимать по заранее выбранным критериям, а не по одной удачной или неудачной картинке. После пяти тестов у вас должны быть данные о точности выполнения промта, поведении при повторе, точности редактирования и результате увеличения качества. Если какой-то критерий для проекта обязательный, его результат нужно рассматривать отдельно от остальных.
Например, для генерации карточек товаров критичнее соблюдение состава сцены и точное редактирование, чем разнообразие случайных художественных деталей. Для иллюстраций может быть важнее соответствие подробному описанию. В обоих случаях решение принимается из требований вашей задачи: тест должен показать, выполняется ли конкретное условие, а не просто понравилась ли одна картинка.
Если результат теста оказался неоднозначным, повторяйте именно тот сценарий, который дал неопределённый ответ. Не стоит расходовать остаток на полностью новые сюжеты. При ограниченном бюджете один контролируемый повтор даёт больше информации, чем несколько несвязанных генераций.
После проверки зафиксируйте итоговые затраты и отдельно стоимость операций, которые реально понадобятся в рабочем процессе. Оплата в API производится за запуск, без абонентской платы и без минимального платежа. Для генерации изображений и других операций это позволяет считать расход непосредственно от количества запусков; у озвучки текста цена указана за 1000 знаков.
Если после тестов понадобится автоматизация, можно оставить тот же принцип: получать баланс перед серией задач, учитывать стоимость запуска, сохранять идентификатор каждой задачи и проверять её результат. Для сервисов, где ответ приходит асинхронно, пригодится callback_url. При любом варианте не стоит забывать о лимите 60 запросов в минуту на ключ.
Отдельно полезно проверить саму механику API до написания большого кода: получить список операций через /services, посмотреть баланс через /balance, выполнить одну задачу через /generate и получить её состояние через /tasks/{id}. Такой короткий цикл помогает отделить проблемы запроса от качества результата генерации.
Частые вопросы
Сколько денег начисляется при выпуске первого ключа?
При выпуске первого ключа на баланс начисляется 50 ₽ на пробу. Этого достаточно для нескольких дешёвых запусков, но недостаточно для полного набора из двух базовых тестов, повтора, редактирования и upscale, который в приведённой схеме стоит 112 ₽.
Можно ли использовать api генерации изображений бесплатно без оплаты?
Для первичной проверки предусмотрен пробный баланс: при выпуске первого ключа начисляется 50 ₽. Дальше операции оплачиваются за запуск, без абонентской платы и без минимального платежа.
Как узнать остаток средств перед тестом?
Используйте GET /balance с заголовком Authorization: Bearer <ключ>. Это удобно делать перед каждой серией тестов, особенно если часть баланса уже потрачена.
Как получить ссылку на загруженное изображение?
Для загрузки файла предусмотрен POST /uploads. В ответе можно получить ссылку, которую затем использовать при работе с операцией редактирования.
Нужно ли постоянно опрашивать состояние задачи?
Нет, для этого предусмотрен необязательный параметр callback_url. После готовности задачи на указанный адрес приходит POST. Без callback можно проверять состояние через GET /tasks/{id}.
Где взять ключ для API?
Ключ выдаётся в разделе API после входа и показывается один раз. Перед началом тестов сохраните его в безопасном месте и используйте в заголовке Authorization: Bearer <ключ>. Открыть страницу API и получить доступ можно из личного кабинета.
