Введение
Krea 2 Medium — повседневный уровень линейки Krea 2: он не тянется к финишной детализации материалов, как Large, и не гонится за скоростью Medium Turbo. Фотографичный вид линейки при естественном свете сохраняется, а цена и темп рассчитаны на объём.
Krea 2 Medium — уровень линейки Krea 2 для больших объёмов: один эндпоинт «текст в изображение», промпт до 5000 символов, пять соотношений сторон и выбор между PNG и JPEG. Для кадров, которых нужно много.
Ключевые возможности и особенности
Фотографичное направление для работы в объёме
Krea 2 Medium подходит для генерации множества кадров-кандидатов, пока команда ещё выбирает композицию и визуальное направление. Сравнивайте кандидатов с одним творческим брифом, а не смешивайте несвязанные идеи в одной серии.
Сохраните утверждённый бриф для следующего этапа
Когда направление прошло ревью, храните формулировку и выбранный кадр вместе. Такая запись полезнее для финальной доработки, чем расплывчатая просьба позже воссоздать тот же вид.
Модель — для нового кадра, а не для правки исходника
Этот режим начинается с письменной постановки. Если существующее изображение должно сохранить свой образ или компоновку, выберите режим правки, а не просите генерацию только по тексту приблизиться к исходнику.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | До 5000 символов. Начинайте с субъекта, затем композиция, свет и материал; остальное лучше не договорить, чем набить эпитетами. Не менее 1 символов · Не более 5000 символов |
aspect_ratio | Нет | По умолчанию квадрат, плюс пять форм, которых просят размещения: от горизонтального 16:9 до портретного 9:16. |
output_format | Нет | По умолчанию png, есть jpeg. png без потерь и безопаснее для передачи в дальнейшую правку или композ; jpeg меньше по весу и достаточен для обсуждения и веба. |
Стоимость
$0.03 / изображение
Сценарии использования
Начать с письменного брифа
Используйте этот эндпоинт, когда один бриф должен дать много кандидатов: промпт до 5000 символов, пять соотношений сторон и PNG по умолчанию, чтобы отобранные кадры сразу шли в ретушь. Входного изображения нет, поэтому всё направление должно быть в словах.
Внутренние превью и черновики питча
Качества хватает, чтобы показать концепцию, не расходуя время финишного уровня на кадр, который потом заменят. Согласованная формулировка переходит в Krea 2 Large как есть.
Редакционные и портретные серии
Портреты при естественном свете, интерьеры и стайлинговые кадры — по пятьдесят за раз через один эндпоинт. Практичным это делает PNG по умолчанию: отобранные кадры идут сразу в ретушь, без повторного экспорта, и ничего не теряется при сжатии с потерями до того, как кто-то сделал выбор.
Материалы для соцсетей и лент
Medium предлагает 1:1, 4:3, 3:4, 16:9 и 9:16 — без широкоэкранного и анаморфотного формата, — поэтому сначала выберите формат размещения и пишите промпт под него. Выбирайте JPEG, если кадры идут сразу в ленту, и PNG, если их будут ретушировать.
Руководство по промптам и практические советы
Описывайте свет, а не прилагательные
Опишите, откуда идёт свет и на что он падает — прикроватная лампа, окно в сумерках, одна голая лампочка, — и назовите объектив и плёнку. Точный свет даёт фотографичному виду этой линейки больше, чем слова вроде «потрясающий» или «гиперреалистичный».
Храните промпт рядом с удачным кадром
Без seed удачный кадр нельзя сгенерировать повторно. Сохраняйте промпт рядом с файлом, а формулировку, прошедшую согласование, переносите для финишной доработки в Krea 2 Large без изменений.
Адаптируйте приложенный пример
Начните с опубликованного примера с aspect_ratio: 3:4 и output_format: png. Замените объект и творческое направление, сохранив контракт входных данных этого режима.
Available-light photograph seen through a half-open hotel room door, an adult woman sitting on the edge of a made bed wearing only an oversized cream knit sweater, bare legs crossed, absorbed in her phone, one warm bedside lamp, deep falling shadows, quiet and unposed, muted amber palette, 50mm, fine film grain.
Промпт, по которому получен референсный кадр этого эндпоинта: здесь он работает без изменений, хотя показанное изображение сделано на уровне Turbo той же линейки как референс стиля.
Проверьте результат, прежде чем повторять
Три поля, и только: prompt, aspect_ratio и output_format. Seed нет, поэтому ничего нельзя зафиксировать, и кадр, который стоит сохранить, нужно хранить вместе с промптом. Этот эндпоинт не принимает изображений на вход — ни «изображение в изображение», ни референсов — и не имеет регулятора креативности. Для референсов стиля используйте Krea 2 Medium Turbo или Krea 2 Large, для максимальной детализации — Krea 2 Large. Широкоэкранного и анаморфотного формата у Medium тоже нет.
Быстрый старт 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/2-medium/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1",
"output_format": "png"
}
}'
# 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.
