Введение
Krea 3: редактирование изображений меняет или объединяет от одного до восьми исходных изображений по инструкции на простом языке. Krea создала Krea 3 в первую очередь для правок: скажите, что должно измениться и что должно остаться, и ссылайтесь на исходники как image 1, image 2 и так далее. Формат результата задаёте вы; каждый результат около мегапикселя.
Выберите режим по исходному материалу
| Что у вас есть | Режим |
|---|---|
| текстовое описание | Krea 3: генерация по тексту |
| от одного до восьми фото для изменения или объединения | Krea 3: редактирование изображений |
Ключевые возможности и особенности
Объединяйте людей, одежду и места
До восьми исходников в одном запросе. В нашем примере женщина с image 1 носит платье с пейсли из image 2 на террасе каньона, при этом лицо и волосы сохраняются.
Называйте исходники по номеру
«The person from image 2» выбирает вторую загрузку: в нашей проверке с женщиной как image 1 и мужчиной как image 2 появился только мужчина.
Личность сохраняется при сильных изменениях
Женщина в офисном жакете стала портретом 1970-х в кабинете с деревянными панелями с тем же лицом, косами и кадрировкой.
Только контент уровня моды
Запросы и исходники проверяются. Смена наряда и сцены проходит; запросы снять одежду отклоняются и не оплачиваются.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Скажите, что менять, затем что остаётся. Ссылайтесь на исходники как image 1, image 2 в порядке загрузки. Не менее 1 символов · Не более 5000 символов |
image_urls | Да | От одного до восьми изображений в порядке, в котором их называет промпт. Каждое добавляет цену результата ещё раз. Не менее 1 элементов · Не более 8 элементов |
aspect_ratio | Нет | Формат результата: 1:1, 4:5, 3:4, 2:3, 9:16, 5:4, 4:3, 3:2, 16:9 или 21:9. По умолчанию 1:1; форма исходника не сохраняется автоматически. |
quality | Нет | high (по умолчанию) сильнее в деталях; fast возвращает быстрее. Цена одинаковая. |
enable_thinking | Нет | Дольше планирует промпт перед генерацией; в наших тестах примерно вдвое медленнее. По умолчанию выключено. По умолчанию: |
negative_prompt | Нет | Что исключить, до 1 024 символов. Работает только в качественном варианте. Не более 1024 символов |
output_format | Нет | PNG (по умолчанию) или JPEG. На цену не влияет. |
seed | Нет | Необязательно, от 0 до 2147483647. Повторное использование seed приближает к прошлому изображению, но не гарантирует совпадения. |
Стоимость
$0.072 / изображение
Оплата за изображение: цена результата плюс такая же сумма за каждое исходное изображение. Вариант качества, размышление и соотношение сторон на цену не влияют. Отклонённые запросы не оплачиваются.
Сценарии использования
Виртуальная примерка и стайлинг
Портрет плюс фото предмета одежды превращается в стилизованный кадр того же человека в этой вещи.
Перестановка и образы разных эпох
Переместите героя в новое место, эпоху или свет, сохранив, кто он.
Руководство по промптам и практические советы
Начинайте с изменения
Сначала скажите, что должно измениться, затем одним предложением, что остаётся. Для нескольких исходников называйте каждый: «the woman from image 1», «the dress from image 2».
Выбирайте формат результата
Результат использует выбранное вами соотношение сторон, а не форму исходника. Совпадите соотношение с главным фото, чтобы избежать нежелательного кадрирования.
Следите за числом исходников
Каждый исходник оплачивается сверх результата, поэтому отправляйте только те, что использует промпт. Указывайте возраст людей, если меняете их эпоху или стиль: образ может сместиться моложе или старше.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "krea/3/edit",
"input": {
"aspect_ratio": "1:1",
"image_urls": [
"https://example.com/reference.png"
],
"output_format": "png",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"quality": "high"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.










