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].Параметры
При использовании
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
Получайте уведомление о завершении задания вместо опроса.