Введение
Текстовое описание, прямые URL файлов весов и их сила определяют стилизованный запрос; необязательный seed помогает оценить действие подключения.
| Характеристика | Значение |
|---|---|
| Ввод | Текст |
| Вывод | Изображение |
| Задачи модели | Генерация по тексту и редактирование; статичные изображения |
| Семейство модели | Открытые веса MiniMax H3-Image с подключением LoRA |
| Подключаемые LoRA | До 3 прямых URL файлов .safetensors |
| Интенсивность LoRA | 0–4 для каждого файла; по умолчанию 1 |
| Длина описания | Обязательное; до 5 000 символов |
| Выбор разрешения | 1k, 1.5k, 2k, 3k, 4k; по умолчанию 1k |
| Формы холста | 15 пропорций; генерация по тексту по умолчанию 1:1 |
| Картинки для редактирования | 1–9 картинок: исходник и до 8 референсов |
| Токены источников | <Picture 1>, <Picture 2> и последующие номера в порядке загрузки |
| Формат выдачи | По умолчанию jpeg; доступны png и webp |
| Настройка сравнения | Необязательный seed помогает сравнить одно изменение без гарантии совпадения |
| Проверенные размеры | 1.5k при 9:16: 1152 x 2048; 4k при 16:9: 5472 x 3072 |
Ключевые возможности и особенности
Неон через обработку видеокамеры
Новый пример 1k, 16:9 показывает женщину в красном платье-комбинации, танцующую в мотеле. С vh5tape и scale 1 VHS LoRA придала всему кадру мягкий вид домашнего видео 1990-х.
Кассетный эффект приносит свои слова
В танце в закусочной есть зерно записи и vh5tape слева внизу. Этот артефакт — причина проверять текст наряду с выбранным стилем до принятия результата.
Гоночный автомат в мягкой записи
Аркадный пример применяет VHS к двум игрокам среди неона. Это вторая сцена для оценки влияния адаптера на людей и окружение.
Другой язык рисунка для гавани
Studio1939 style перерисовал гавань в чёрно-белый мультфильм с гибкими формами лодок. Расположение городского силуэта осталось узнаваемым.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Обязательный связный текст до 5 000 символов: сначала триггерное слово файла весов, затем сцена. Описания по умолчанию и отдельной платы за текст нет. Не менее 1 символов · Не более 5000 символов |
aspect_ratio | Нет | Доступны пропорции 1:1, 1:2, 2:1, 1:3, 3:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 9:21, 21:9. По умолчанию генерация использует 1:1; выбор пропорций не меняет оплату. |
resolution | Нет | Для стилизованной генерации по умолчанию используется 1k; более дорогие варианты — 1.5k, 2k, 3k и 4k. |
loras | Нет | Необязательный список максимум из трёх элементов {path, scale} с прямыми URL файлов .safetensors, например ссылками Hugging Face /resolve/main/. По умолчанию: |
output_format | Нет | Изображение сохраняется в jpeg, если не выбран png или webp; формат не влияет на стоимость. |
seed | Нет | При желании задайте seed для сравнения с LoRA и без неё; фиксированное значение по умолчанию и числовые границы не указаны. |
Стоимость
Готовое изображение оплачивается по выбранному уровню открытых весов с фиксированной доплатой за LoRA, даже без файлов. Один или три файла не меняют доплату; неудачные запросы не оплачиваются.
| Спецификация | Стоимость |
|---|---|
| $0.042 / изображение |
| $0.054 / изображение |
| $0.066 / изображение |
| $0.114 / изображение |
| $0.162 / изображение |
Сценарии использования
Этюды неонового мотеля
Пример мотеля с красным платьем использует VHS LoRA со scale 1 и превращает ночной танец в мягкий кадр с видеокамеры. Оценивайте обработку всего кадра для подборки настроения эпохи кассет.
Стилизация готовой фотографии
Наш LoRA мультфильмов 1930-х превратил фото в анимационный рисунок с гибкими линиями и сохранил позу. Пример гавани показывает близкую правку с сохранением расположения силуэта города.
Сначала сравните адаптер
Сохраняйте seed и описание, включая и отключая LoRA. В VHS-сравнении менялось и кадрирование, и текстура: оцените оба до выбора большего разрешения.
Вернитесь к портретной обстановке
В тестах правки одежды и места по одной картинке сохраняли лицо. Добавляйте LoRA отдельным сравнением, чтобы оценить влияние на человека и окружение.
Сочетайте героя и сцену
Композиция из двух картинок в тестах сработала. Ставьте редактируемый источник перед сценой и называйте каждую картинку в инструкции для стилизованного сочетания.
Руководство по промптам и практические советы
Выберите генерацию или правку
Для генерации начните с описания; для правки сначала передайте изменяемую картинку, затем вспомогательные референсы. Всего принимается до девяти входов.
Подключите скачиваемую LoRA
Направьте path на сам .safetensors, при необходимости через Hugging Face /resolve/main/. Начните с scale 1; для файла доступны 0–4, в запросе до трёх файлов.
Опишите сцену и стилизацию
Перед подробным английским описанием одежды, действия, света и окружения поставьте триггер LoRA. Для правки назначьте источнику <Picture 1>, остальным — собственные номера.
Сравните и рассмотрите кадр
Выберите пропорции, разрешение и формат, затем сравните запросы с LoRA и без неё при фиксированном seed. Проверьте стиль, композицию и лишние надписи; seed не обещает одинаковый результат.
Создание кадра с подключённой обработкой
MiniMax H3-Image Open Weights LoRA превращает описание в изображение и принимает до трёх файлов весов LoRA. Подходит заданию, где нужный вид приходит из адаптера, как VHS в примерах мотеля и закусочной. Результат статичен: видеоклип и звуковая дорожка не создаются.
Проверенные адаптеры обучались для видеомодели H3, но повлияли и на этот чекпойнт изображений. Это свидетельство для конкретных файлов, а не обещание совместимости всех H3-адаптеров. Начните с известного файла и сцены, где легко рассмотреть одежду, свет и окружение.
Настройки запроса
| Параметр | Значения и поведение |
|---|---|
prompt | Обязательное описание до 5 000 символов; триггер адаптера перед сценой |
loras | До трёх элементов с path и scale; прямой URL скачивания .safetensors |
loras[].scale | 0–4 для каждого файла; по умолчанию 1 |
aspect_ratio | 1:1, 1:2, 2:1, 1:3, 3:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 9:21 или 21:9; по умолчанию 1:1 |
resolution | По умолчанию 1k; также 1.5k, 2k, 3k и 4k |
output_format | По умолчанию jpeg, также png и webp |
seed | Необязательная настройка сравнения; не обеспечивает идентичность |
Ссылка Hugging Face должна вести через /resolve/main/ к имени файла весов. Обзор репозитория не указывает скачиваемый файл для path. Триггер ставится в промпт, URL и scale — в элемент LoRA; один триггер файл не подключает.
Сцена для выбранной обработки
Напишите связный английский абзац с ясным героем, действием, одеждой, местом и светом. Для VHS-этюда можно предложить: «vh5tape, женщина ближе к сорока в красном платье-комбинации танцует у жалюзи мотеля, смеётся в камеру, пурпурный неон и тёплая прикроватная лампа, домашнее видео 1990-х». Пропорции и разрешение задавайте настройками, а не помещайте все требования выдачи в описание.
Одно изменение за сравнение
- Сохраните вместе описание, холст, seed и ссылку файла.
- Создайте запрос с файлом и контрольный без подключения.
- До изменения scale рассмотрите текстуру, кадрирование, выражения и надписи.
- Меняйте одну настройку, а не всё задание целиком.
Фиксированный seed помогает выделить изменение, но не замораживает сцену. В VHS-сравнении менялась и композиция. При нескольких файлах оценивайте сочетание, не предполагая, что каждый даёт отдельный неизменный слой.
Что устанавливают примеры
Новый мотель использовал VHS со scale 1, vh5tape, seed 11, 1k и 16:9. Получилась женщина в красном платье-комбинации, танцующая в комнате мотеля, с мягким видом записи по всему кадру. Игровой зал даёт другое окружение для оценки приёма.
Закусочная выявила артефакт: vh5tape в углу. Некоторые адаптеры переносят обучающие слова или водяные знаки. Проверяйте края и фоновые вывески до выбора картинки. В тестах H3-Image короткие вывески и этикетки читались, но это не гарантирует длинные тексты или надписи с любым адаптером.
Цена и ошибки запросов
Плата начисляется за готовое изображение. Базу определяет разрешение: более крупные уровни дороже; версия LoRA добавляет фиксированную надбавку к Open Weights. Она одинакова при нуле, одном и трёх файлах. Смена jpeg, png и webp цену не меняет. Тарифы смотрите на странице модели.
Наш тест отсутствующего файла остановился с Failed to load LoRA. Запасной картинки и платы не было; неудачные запросы бесплатны. Исправьте ссылку скачивания до повторной отправки.
Границы и соседние варианты
Любой незнакомый адаптер нужно оценить. Наблюдаемые стили не гарантируют личность, расположение или чистые надписи в новых сценах. Проверки содержания не дали отказов, но часть результатов была мягче; стандартный тест генерации проходил без LoRA и не устанавливает поведение адаптера.
Для пяти уровней и seed без подключения весов выбирайте Open Weights. MiniMax H3-Image даёт три уровня и до шестнадцати входов без seed. Для готовой фотографии используйте image-to-image этого семейства. Прежняя H3 Image LoRA создаёт кадр видеомоделью, здесь — чекпойнт H3-Image. P-H3-Image отдельна; сравнения одинаковых промптов не дали совпадающих картинок.
Быстрый старт 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": "minimax/h3-image-open-lora/text-to-image",
"input": {
"aspect_ratio": "1:1",
"output_format": "jpeg",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# 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.
























