GPT Image и Nano Banana: изображения через CLODEx

Для иллюстраций, продуктовых изображений и референсных кадров можно использовать доступные image-модели CLODEx. Начать удобно через интерфейс изображений; для автоматизации есть API.

GPT Image и Nano Banana — разные модели. Не переносите между ними размеры, качество, формат ответа и параметры редактирования без проверки.

Что подготовить

• Ключ для интеграции из личного кабинета.
• Доступную image-модель и её тариф из каталога.
• Средства в кошельке.
• Актуальный пример выбранной модели из раздела изображений в /docs.

Если запускаете операцию внутри Studio, учитывайте отдельное правило Studio: используется платный баланс. Условия публичного API и доступность конкретной операции проверяйте отдельно.

Генерация по описанию

Основной путь — POST https://clodex.xyz/v1/images/generations. Авторизация — Authorization: Bearer YOUR_CLODEX_API_KEY.

Пример тела для Nano Banana; перед запуском проверьте доступность ID и поддерживаемые параметры:

{
  "model": "nano-banana-2",
  "prompt": "Минималистичная предметная фотография керамической чашки на светлом фоне",
  "n": 1,
  "response_format": "b64_json"
}

В этом формате изображение нужно извлечь из соответствующего поля ответа и декодировать из base64. Для другого маршрута результат может передаваться иначе, в том числе через поток событий. Не ищите картинку в choices[0].message.content, как в обычном текстовом Chat Completions.

Редактирование изображения

В /docs описан маршрут POST /v1/images/edits для поддерживаемых моделей. Он отличается от простой генерации: могут понадобиться multipart-загрузка, исходное изображение и специфические поля модели.

Используйте пример именно выбранной модели. Наличие image generation не доказывает поддержку маски, нескольких референсов или любого формата файла. Для пользовательского приложения проверяйте тип и размер входных файлов на своём сервере.

Как проверить результат и цену

Сначала выполните одну генерацию небольшого объёма. Проверьте содержимое ответа, возможность открыть файл и фактическое списание в кабинете. При редактировании сравните результат с исходником и убедитесь, что нужные элементы сохранены.

Цена изображения может зависеть от модели, качества и других параметров. Не фиксируйте в интеграции сумму из старого снимка прайса и не повторяйте запрос автоматически после каждого тайм-аута: операция могла уже выполниться.

Практический сценарий

Можно подготовить описание сцены в чате, сгенерировать исходный кадр и передать его в видеогенерацию, если модель поддерживает image-to-video. Это несколько отдельных операций, каждая со своими условиями оплаты и форматом входа.

Безопасность

Храните API-ключ на backend, а не в публичном браузерном коде. Используйте только изображения, которые вправе обрабатывать, и отдельно проверяйте условия коммерческого использования результата. Не считайте любое AI-изображение свободным от прав третьих лиц.

Открыть изображения на сайте · Примеры image API · Выбрать тариф.