Перейти к основному содержанию
Опишите изображение в браузере или вызовите генерацию из своего приложения. Чтобы изменить существующее изображение, добавьте референсы.

Перед началом

  • Войдите в aibal.ai и подготовьте активный API-ключ с доступом к генерации изображений.
  • Проверьте баланс аккаунта и лимит ключа; при необходимости пополните баланс. Генерация в браузере тоже оплачивается.
  • Загружайте только материалы, которые вы вправе обрабатывать. Не используйте изображения паролей, документов и других конфиденциальных данных.
Доступные модели, параметры и цены определяются текущими условиями в панели управления. В примерах используется модель онлайн-студии gpt-image-2.

Генерация в браузере

Генерация изображений: промпт, референсы и сообщение об отсутствии активного API-ключа

Страница генерации изображений: API-ключ ещё не создан; подготовьте его перед генерацией.

1

Откройте генерацию изображений

Откройте генерацию изображений и выберите API-ключ в области параметров. Если активного ключа нет, нажмите Управление API-ключами, создайте или включите ключ и вернитесь.
2

Выберите параметры

Для первой попытки оставьте Пропорции и размер: Авто, Качество: Авто, Количество: 1, Формат: PNG. Серые варианты размера недоступны; наличие варианта на странице не означает, что его можно использовать.
3

Опишите изображение

В поле Промпт укажите объект, сцену, композицию и стиль. Например: «Рыжий котёнок у солнечного окна, мягкий дневной свет, размытые зелёные растения на фоне, акварельная иллюстрация, без текста».Для генерации из текста референс не нужен.
4

Отправьте запрос

Нажмите Создать и дождитесь смены статусов Отправка и Обработка на Готово. Держите страницу открытой. При обрыве соединения сначала проверьте историю использования.
5

Просмотрите и сохраните

Нажмите Просмотр на карточке результата, затем Скачать. Для дальнейших изменений используйте Копировать промпт или Повторить параметры.
Список результатов генерации изображений хранится в текущем сеансе страницы. Скачайте нужные файлы перед обновлением или выходом. Закрытие страницы не означает отмену генерации у поставщика.

Выбор параметров

Параметры разрешения, качества, количества, формата, сжатия и фона

Параметры генерации изображений. Оставьте авто, если фиксированные размеры недоступны.

Редактирование по референсам

Нажмите Добавить референсы (необязательно) и загрузите PNG, JPEG или WebP. Допускается до 4 файлов, до 10 МБ каждый и до 40 МБ суммарно. При нескольких изображениях можно выбрать Сделать главным; для ненужного файла нажмите Удалить. Опишите изменение, например: «Сохрани объект и композицию, замени фон на светло-голубой». Нажмите Создать, затем просмотрите и скачайте результат. Готовое изображение также можно выбрать действием Как референс.

Генерация через API

Установите curl и безопасно задайте переменную окружения AIBAL_API_KEY на своём устройстве. Не записывайте настоящий ключ в документацию, общие скрипты или репозиторий. Эти команды отправляют реальные запросы и могут привести к списаниям.

Запрос генерации из текста

Отсутствие size и quality соответствует автоматическим настройкам веб-страницы. При успехе массив data содержит изображения в виде b64_json или url; не каждый ответ содержит готовую ссылку. Если есть data[0].b64_json, сохраните первый PNG с помощью Python 3:
Если возвращён data[0].url, откройте ссылку и скачайте результат. Не передавайте API-ключ aibal.ai на адрес изображения.

Запрос редактирования изображения

Замените /path/to/reference.png реальным путём к файлу. Используется отправка формы; не задавайте заголовок Content-Type для JSON.
Для нескольких референсов повторите -F "image[]=@...". Сохранение результата выполняется так же, как при генерации из текста.

Особенности использования в Codex

Клиенты с обработчиком генерации изображений

Для ключей группы OpenAI в панели доступны две конфигурации Codex: Режим совместимости и Режим API-ключа (API Key Mode). Первый сохраняет настройку для старых клиентов, а второй авторизует обработчик изображений в клиентах, поддерживающих эту возможность.
1

Откройте конфигурацию ключа

В списке API-ключей aibal.ai найдите ключ группы OpenAI, нажмите Использовать ключ и выберите Codex CLI.
2

Выберите режим API-ключа

В разделе Режим аутентификации Codex выберите Режим API-ключа, затем свою операционную систему. Этот вариант отображается только для соответствующих группы и клиента.
3

Сохраните полную конфигурацию

Сохраните сформированную конфигурацию по инструкции окна. Если требуется файл каталога моделей, сохраните и его. Сначала сделайте резервную копию настроек; не смешивайте эту схему с ручным env_key или фрагментами auth.json из режима совместимости. Скопированные настройки содержат настоящий ключ — храните их приватно на своём устройстве.
4

Полностью перезапустите клиент и создайте задачу

Полностью закройте Codex Desktop или CLI, откройте снова и создайте новую задачу. Обновления старой задачи или продолжения сеанса недостаточно для повторной инициализации, требуемой панелью.
Этот порядок подходит клиентам с соответствующим обработчиком изображений и не гарантирует встроенную генерацию в каждой версии Codex. Проверьте доступные инструменты своего клиента. Успешный текстовый диалог сам по себе не подтверждает настройку изображений.

Явный вызов API изображений

Также можно поручить Codex вызвать приведённый выше API aibal.ai и сохранить результат локально. Так вы явно задаёте адрес, модель и путь файла, не полагаясь на автоматический выбор встроенного инструмента. Пример задания:
Убедитесь, что среда выполнения видит переменную и может обращаться к сети. Если клиент не выполняет запросы, запустите команды в локальном терминале. Подключение чата описано на странице Codex.

Частые вопросы

Нет активного ключа или недостаточно прав

Проверьте, что ключ включён, не просрочен, не исчерпал лимит и относится к группе с доступом к модели изображений. Вход в аккаунт не даёт такого доступа каждому ключу. См. Создание API-ключа.

Почему недоступны фиксированные размеры?

Страница отключает размеры, которые сейчас не могут быть возвращены в заданном виде. Оставьте Авто и проверьте размеры готового файла. Не обходите ограничения изменением параметров запроса.

Что делать при ошибке, ограничении частоты или неизвестном результате?

При ошибке оплаты проверьте баланс и лимит ключа; при ошибке ввода — формат, референсы и модель. При ограничении частоты подождите; после отказа модерации измените описание или материалы. Если результат и списание неизвестны, сначала проверьте историю использования. Для поддержки сохраните ID запроса и код ошибки, но не отправляйте полный ключ.

Можно ли делиться скопированной командой curl?

Не отправляйте её без проверки. Пример API (curl) на странице может содержать полный ключ. Перед передачей замените его переменной окружения и проверьте историю буфера обмена и снимки экрана. Далее попробуйте генерацию видео или прочитайте обзор подключения.