Skip to main content
Krea 3 — быстрая модель редактирования изображений. Она понимает инструкции на обычном языке: вы описываете, что нужно изменить и что должно остаться прежним, и Krea 3 выполняет правку за считаные секунды. Модель также можно использовать для генерации изображений по тексту.
API Krea 3 находится в раннем доступе. Вызывать его могут только workspace, участвующие в бета-тестировании Krea 3. Чтобы запросить доступ, напишите на sales@krea.ai.

Endpoint

Endpoint работает по стандартному жизненному циклу задания: он возвращает job_id, после чего вы опрашиваете GET /jobs/{job_id} (или используете webhook), пока задание не завершится. Итоговое изображение находится в result.urls[0].

Быстрый старт: ваша первая правка изображения

Все запросы требуют Bearer token. Если у вас его ещё нет, см. API Keys & Billing.
1

Загрузите референс

Отправьте POST /assets с входным изображением. В ответе вернётся image_url. Также можно передать в image_urls напрямую URL внешнего изображения или data URI в base64.
2

Создайте правку

Отправьте POST /generate/image/krea/krea-3 с prompt и референсом. Сохраните job_id из ответа.
3

Получите результат

Опрашивайте GET /jobs/{job_id}, пока status не станет completed. Результат находится в result.urls[0].
Храните API token на своём сервере. Никогда не включайте его в клиентский код.

Параметры

При использовании width и height результат округляется до ближайшего поддерживаемого соотношения сторон и холста 1k или 2k. Точные размеры в пикселях не гарантируются.Повторное использование seed не гарантирует идентичных результатов, поскольку этап расширения prompt может отличаться от запуска к запуску.

Режимы мышления

Перед генерацией Krea 3 интерпретирует ваш prompt. thinking_mode определяет, насколько тщательно модель планирует правку. Если thinking_mode не указан, API использует fast. Оба режима поддерживают regional_edit.

Локальные правки

С regional_edit: true Krea 3 перегенерирует только те части изображения, которые нужно изменить. Всё остальное остаётся в точности как было, поэтому вы можете редактировать одно и то же изображение снова и снова без потери качества. Используйте для локальных правок, когда остальная часть изображения должна сохраниться с точностью до пикселя: перекрасить или заменить объект, добавить или удалить элемент, исправить деталь или изменить текст на вывеске. Это безопасный способ выстраивать цепочку правок поверх последнего результата. Не используйте для глобальных правок, при которых нужно перерисовать всё изображение: смена стиля, освещения, времени года или суток, изменение кадрирования или объединение нескольких изображений в новую сцену. Обычные правки перерисовывают изображение целиком, поэтому при повторном редактировании последнего результата могут накапливаться артефакты. Для локальных правок нужно хотя бы одно изображение в image_urls.

Составление prompt

Krea 3 — редактор, который следует инструкциям. Описывайте правку обычным языком:
  • Начните с самого изменения. Добавляйте только те детали, которые помогают его выполнить.
  • Если остальная часть изображения должна остаться прежней, завершите prompt одним предложением об этом. Не перечисляйте всё, что должно сохраниться.
  • Если в prompt используется несколько изображений, называйте каждое по тому, что на нём изображено. Например: «Надень кроссовок со второго изображения на человека с первого изображения».

Изображения-референсы

  • Krea 3 использует каждый референс в том разрешении, в котором он был загружен. Референс больше 4 MP уменьшается до 4 MP.
  • Для большинства правок достаточно около 1 MP. Не увеличивайте разрешение референса перед отправкой.
  • Если важны мелкие детали (мелкий текст, логотипы, ткань, лица на общем плане), отправляйте версию изображения с максимальным доступным разрешением.
  • Если в одном запросе пять или более референсов, каждый уменьшается до 1536 px по длинной стороне. Чтобы сохранить все детали, отправляйте не более четырёх референсов.

Zero Data Retention

Krea 3 поддерживает Zero Data Retention для enterprise-workspace. Передайте заголовок X-Api-Zero-Data-Retention: 1. В режиме Zero Data Retention:
  • Каждое изображение в image_urls должно быть data URI в base64.
  • thinking_mode может быть fast или high.
  • В одном запросе можно использовать не более 4 изображений-референсов.

Тарифы

Цена за изображение зависит от разрешения результата, режима мышления и изображений-референсов.

См. также

Жизненный цикл задания

Статусы заданий, опрос и результаты.

Webhooks

Получайте уведомление о завершении задания вместо опроса.