Krea

Krea 3

krea-3/text-to-image

Поддерживает генерацию по тексту и редактирование по референсному изображению, нативный вывод в 2K, около 8 секунд на одно редактирование — подходит для высокочастотных визуальных итераций и повторного использования материалов

krea-3/text-to-image

Попробовать krea-3/text-to-image

Ввод

Работы

Все работы

Вывод

image

Заполните параметры и сгенерируйте — результаты появятся здесь.

От реализма к плоскости: спектр иллюстративных стилей Krea 3

Стиль Иллюстрация · style-spectrum · Редакционная категория

Промпт

Редакционная стилизованная иллюстрация: в сумерках одинокая фигура стоит на краю прибрежного обрыва, показанная с низкой точки в ракурсе три четверти, композиция размещена в горизонтальном формате 16:9 с большим негативным пространством справа. Сцена написана отчётливо видимыми живописными мазками: море и небо переданы слоями холодных сине-серых цветовых пятен, скалы обрыва тронуты тёплой охрой, мягкий контурный свет очерчивает силуэт фигуры, формы упрощены, остаются структурно читаемыми, но отнюдь не стремятся к фотографическому реализму. Средняя плотность деталей — трава на переднем плане написана выразительными мазками, и чем ближе к горизонту, тем шире мазки. Общая палитра мягкая, малонасыщенная, сохранён лишь один тёплый акцент. Без текста, без водяных знаков, без лишних конечностей.

Скопируйте полный промпт и адаптируйте под свою задачу.

Теги

Krea 3 Изображения товаров для электронной коммерции: свет и тени на столешнице и фактура материалов

Стиль Изображение продукта · электронная коммерция · Студийный свет

Промпт

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

Скопируйте полный промпт и адаптируйте под свою задачу.

Теги

Цены

krea-3/text-to-image per image

Цена за единицу	$0.036

Краткое описание

krea-3/text-to-image — это модель Krea для задач генерации изображений по текстовому описанию, вызываемая через единый интерфейс HiAPI.ai. Она принимает текстовые промпты и генерирует изображения, предлагая несколько предустановленных размеров — квадратный, портретный и альбомный, — а на выходе выдаёт PNG или JPEG. Линейка поддерживает два варианта: berry и jam, первый ориентирован на качество изображения, второй — на скорость; кроме того, можно задать уровень рассуждений, негативный промпт и фиксированный случайный seed для воспроизведения одного и того же результата. Модель подходит командам разработчиков, которым нужно балансировать качество и скорость генерации в зависимости от проекта и встраивать пакетную генерацию в собственные процессы.

Ключевые особенности

Выбор между качеством и скоростью — параметр variant предлагает варианты berry и jam: первый делает упор на качество, второй — на скорость; их можно переключать в зависимости от задачи.
Настраиваемый уровень рассуждений — reasoning_level принимает значения low или medium и управляет степенью рассуждения и расширения промпта перед генерацией; medium требует больше времени.
Управляемые размер и формат вывода — шесть встроенных пресетов: квадрат, портрет 4:3/16:9 и альбом 4:3/16:9, максимум 1024×1024; вывод в PNG или JPEG.
Воспроизводимость через фиксированный seed — передача seed позволяет при одинаковых входных данных получать один и тот же результат, что удобно для отладки промптов и сравнения версий.

Описание возможностей

Генерация изображений по текстовому промпту: единственный обязательный вход — текстовое описание, на выходе одно изображение; prompt длиной до 5000 символов вмещает достаточно полное описание субъекта, стиля и композиции.

Исключение элементов через негативный промпт: параметр negative_prompt (до 1024 символов) задаёт то, что не должно появляться на изображении, добавляя ещё один уровень контроля над картинкой.

Шесть пресетов размера и выбор формата: выберите квадратный, портретный или альбомный пресет под место итоговой публикации и сразу выводите PNG или JPEG, сокращая последующие шаги конвертации.

Воспроизведение результата через параметры: при фиксированных seed, reasoning_level и прочих параметрах одинаковые входные данные стабильно дают одинаковый вывод, что удобно для создания повторяемой базовой линии генерации.

Сценарии применения

Пакетная генерация иллюстраций для контент-команд — выберите пресет под размер рубрики и получите одну иллюстрацию за один вызов для обложек статей, изображений для соцсетей и других мест, где нужна стабильная генерация.
Настройка промптов дизайнерами и разработчиками — зафиксировав seed, последовательно меняйте prompt и негативный промпт, сравнивайте различия в выводе и формируйте переиспользуемые шаблоны промптов.
Единый источник для портретных и альбомных материалов — используя одно и то же описание, переключайтесь между пресетами portrait и landscape и получайте материалы в одном стиле для мобильных и веб-версий.
Быстрая проверка прототипов, чувствительная к скорости генерации — выберите вариант jam и понизьте уровень рассуждений, чтобы на раннем этапе быстро получить несколько направлений, а затем выпустить доработанную версию с berry.

Ограничения и рекомендации по выбору

Поддерживается только генерация по текстовому промпту: модель не принимает референсные изображения и не выполняет локальное редактирование, поэтому для image-to-image или локальных правок следует выбирать модели с соответствующими возможностями. Максимальный размер вывода — 1024×1024, готовые материалы высокого разрешения нужно дополнительно увеличивать. negative_prompt действует только для варианта berry; при выборе jam этот параметр не работает. Каждый вызов возвращает одно изображение, для нескольких вариантов нужны несколько запросов. Если задача требует строгого воспроизведения внешности существующего персонажа или продукта, чисто текстовое описание вряд ли обеспечит согласованность.

Частые вопросы

Все частые вопросы →

Для чего подходит Krea 3?

Подходит для реалистичной фотографии, портретов, предметной съёмки, еды, архитектурных пространств, иллюстраций и концепт-дизайна, а также умеет создавать постеры с текстом заголовка. Даже короткие промпты дают полноценное изображение, что подходит для быстрого поиска направления.
В чём разница между berry и jam?

Это два варианта одной и той же модели с почти одинаковыми параметрами (negative_prompt действует только на berry): Krea позиционирует berry как приоритет качества, а jam — как приоритет скорости, при этом оба стоят одинаково. Переключение выполняется через input.variant, по умолчанию — berry. В реальных сравнениях при одном и том же seed композиция и цветовая гамма у них различаются, а качество изображения сопоставимо, так что можно попробовать оба варианта и выбрать подходящий.
Что такое reasoning_level? Какой выбрать?

Он управляет тем, сколько усилий модель тратит на понимание и расширение промпта перед генерацией изображения; доступны значения low и medium (по умолчанию). Используйте medium, если промпт очень короткий или абстрактный; используйте low, если промпт уже написан очень конкретно и вы хотите быстрее.
Какие размеры поддерживаются?

image_size поддерживает 6 вариантов: square_hd (1024 × 1024, по умолчанию), square (512 × 512), portrait_4_3 (768 × 1024), portrait_16_9 (576 × 1024), landscape_4_3 (1024 × 768), landscape_16_9 (1024 × 576).

Создать задачу генерации

POST https://api.hiapi.ai/v1/tasks

Заголовки

AuthorizationstringОбязательно

API-ключ аккаунта. Обязателен в каждом запросе. Пример: Bearer YOUR_HIAPI_API_KEY. Получить API-ключ

Content-TypestringНеобязательно

Тело запроса всегда разбирается как JSON; при отправке принимается только application/json (charset опционален) — любое иное значение возвращает 415. Пример: application/json.

Idempotency-KeystringНеобязательно

Ключ идемпотентности, до 255 байт. Повторные запросы с тем же ключом того же аккаунта создают задачу лишь один раз; реплеи возвращают исходный taskId.

Ключ идемпотентности

При сетевых таймаутах или автоповторах клиента один и тот же ключ создаёт задачу только один раз, без двойного списания (область = аккаунт API-ключа). Рекомендуется бизнес-уникальный идентификатор (напр. "order-42"); реплеи возвращают исходный taskId, ключ истекает через 24 часа после первого запроса. Полная матрица сценариев — во введении единого асинхронного API.

Тело запроса

modelstringОбязательно

Текущее фиксированное значение: krea-3/text-to-image

routestringНеобязательно

Текущее фиксированное значение: default

inputobjectОбязательно

Объект бизнес-параметров для krea-3/text-to-image и маршрута default — см. таблицу параметров ниже.

seedintegerНеобязательноmin 0max 2147483647

Фиксированное случайное зерно для воспроизведения одинаковых результатов генерации; принимает целое число, при отсутствии значение выбирается сервером случайно.

promptstringОбязательноminLength 1maxLength 5000

Текстовое описание изображения для генерации, подаётся как промпт для создаваемого контента.

variantstringНеобязательноПо умолчанию: "berry"

Уровень варианта генерации: berry ориентирован на качество, jam — на скорость; по умолчанию berry.

Варианты:berryjam

image_sizestringНеобязательноПо умолчанию: "square_hd"

Предустановка размера выходного изображения, максимально поддерживается 1024×1024; по умолчанию square_hd.

Варианты:square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9

output_formatstringНеобязательноПо умолчанию: "png"

Формат выходного изображения; по умолчанию png.

Варианты:pngjpeg

negative_promptstringНеобязательноmaxLength 1024

Указывает контент, который нужно исключить из изображения; действует только для варианта berry.

reasoning_levelstringНеобязательноПо умолчанию: "medium"

Управляет степенью рассуждения и расширения промпта перед генерацией: чем выше значение, тем глубже обработка, medium относительно медленнее; по умолчанию medium.

Варианты:lowmedium

callbackobjectНеобязательно

Настройка уведомления о терминальном состоянии. Если не задана — обратных вызовов нет, опрашивайте задачу сами.

Обратные вызовы (Webhook)

Укажите callback.url при создании, и HiAPI отправит POST вашему сервису в терминальном состоянии — опрос не нужен. Тело callback повторяет структуру деталей задачи; проверка подписи, повторы и идемпотентность описаны во введении единого асинхронного API.

urlstringОбязательно

Обязательна при наличии callback. В терминальном состоянии на этот URL отправляется POST; это должна быть корректная http(s)-ссылка.

whenstringНеобязательноПо умолчанию: "final"

Сейчас поддерживается только final — уведомление и при success, и при fail.

Варианты:final

storagestringНеобязательноПо умолчанию: "temp"

Уровень хранения артефактов: temp (по умолчанию, ~7 дней) или persistent (долгосрочно, оплата по объёму). При нехватке баланса или превышении лимита — тихое понижение до temp; фактический уровень виден в ответе деталей задачи.

Варианты:temppersistent

Примеры запроса

# Отправляет асинхронную задачу; сразу возвращает taskId (не ждёт генерации)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "krea-3/text-to-image",
  "input": {
    "prompt": "…",
    "variant": "berry",
    "image_size": "square_hd",
    "output_format": "png",
    "reasoning_level": "medium"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "krea-3/text-to-image",
    input: {
      "prompt": "…",
      "variant": "berry",
      "image_size": "square_hd",
      "output_format": "png",
      "reasoning_level": "medium"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "krea-3/text-to-image",
        "input": {
          "prompt": "…",
          "variant": "berry",
          "image_size": "square_hd",
          "output_format": "png",
          "reasoning_level": "medium"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

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

GET https://api.hiapi.ai/v1/tasks/:id

Поля ответа

taskIdstringОбязательно

Идентификатор задачи, всегда с префиксом tk-hiapi-.

modelstringОбязательно

Полное разрешённое имя модели. Задачи, отправленные с параметром route, возвращают base@route (напр. gpt-image-2/text-to-image@ext); иначе совпадает с переданным именем.

routestringНеобязательно

Присутствует только при явном параметре route; повторяет переданное значение.

statusstringОбязательно

Статус задачи.

Значения статуса

queued В очереди, ещё не начата. handling Обрабатывается. archiving Обработка завершена, готовятся артефакты. success Терминальное: завершено, артефакты доступны (возвращается output). fail Терминальное: ошибка (возвращается error). После отправки следите за status: success и fail — терминальные, остальные нет. Опрашивайте каждые 1–3 с до терминального состояния. При успехе скачайте артефакты из output[].url и перенесите до expireAt; для длительного хранения укажите storage: "persistent" при создании.

creatednumberОбязательно

Время создания задачи (Unix-секунды).

completednumberОбязательно

Unix-секунды терминального состояния; до этого — 0.

outputarrayНеобязательно

Только при status == success. Список артефактов — всегда массив; одна задача может вернуть несколько type сразу (напр. video + first_frame).

Array [ object ]

Элементы массива

urlstringОбязательно

URL артефакта, доступен для скачивания напрямую.

typestringОбязательно

Текущие возможные значения: video, image, audio, first_frame, last_frame, thumbnail; список может расширяться.

expireAtnumberОбязательно

Unix-секунды доступности артефакта; скачайте или перенесите до истечения.

errorobjectНеобязательно

Только при status == fail.

codestringОбязательно

Бизнес-код ошибки.

messagestringОбязательно

Описание ошибки.

Примеры ответа

Успех

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

Обработка (не финальное)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Ошибка

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}