Введение
Стилевые веса влияют на правку изображения; <Picture 1> обозначает исходник, а следующие токены — вспомогательные картинки.
| Характеристика | Значение |
|---|---|
| Ввод | Изображение |
| Вывод | Изображение |
| Задачи модели | Генерация по тексту и редактирование; статичные изображения |
| Семейство модели | Открытые веса 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 символов, начав с триггерного слова LoRA и обозначая исходники через . Готового промпта и доплаты за текст нет. Не менее 1 символов · Не более 5000 символов |
image_urls | Да | Добавьте 1–9 URL картинок, начав с обязательного редактируемого исходника; следующие картинки служат референсами, и каждая добавляет небольшую плату к цене правки с первым исход… Не менее 1 элементов · Не более 9 элементов |
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; без значения используется форма первой картинки. |
resolution | Нет | Для стилизованной правки выберите 1k (по умолчанию), 1.5k, 2k, 3k или 4k; цена уровня растёт с размером результата. |
loras | Нет | Для правки передайте до трёх элементов {path, scale} или не подключайте файлы; используйте прямой URL .safetensors, например /resolve/main/ на Hugging Face. По умолчанию: |
output_format | Нет | Результат правки по умолчанию имеет формат jpeg; png и webp доступны по той же цене уровня. |
seed | Нет | При сравнении обработки правок можно сохранить источник случайности. |
Стоимость
Стилизованная правка стоит как выбранный размер открытых весов плюс фиксированная доплата за LoRA на изображение, одинаковая для нуля, одного и трёх файлов. Каждый исходник после первого добавляет плату; ошибки загрузки и другие сбои не оплачиваются.
| Спецификация | Стоимость |
|---|---|
| $0.042 / изображение |
| $0.06 / изображение |
| $0.078 / изображение |
| $0.15 / изображение |
| $0.222 / изображение |
Сценарии использования
Этюды неонового мотеля
Пример мотеля с красным платьем использует 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 не обещает одинаковый результат.
Стилизация источника весами LoRA
Этот эндпоинт MiniMax H3-Image Open Weights LoRA подходит для фотографии или другой готовой картинки. Запрос сочетает редактируемый источник, необязательные референсы, инструкцию и до трёх файлов весов. Можно менять сцену и применять проверенный приём, например адаптер мультфильмов 1930-х.
Порядок важен: <Picture 1> — изменяемая картинка. Следующие входы дают человека, предмет или окружение. Назначьте роли в промпте, отделив изменения от сохраняемых деталей. Если в работе есть люди, выбирайте снимки совершеннолетних с разрешением на использование и не прибегайте к подмене личности.
Параметры редактирования
| Параметр | Допустимое значение и роль |
|---|---|
image_urls | От одной до девяти картинок: источник и до восьми референсов |
prompt | Обязательная инструкция до 5 000 символов; обозначения <Picture N> |
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; без настройки форма источника |
resolution | 1k, 1.5k, 2k, 3k или 4k; исходно 1k |
output_format | jpeg, если не выбраны png или webp |
seed | Необязательный источник случайности для сравнения одного изменения |
Пропорции и разрешение решают разные задачи. Без пропорций форма следует источнику; уровень задаёт размер и цену. Для масштаба: наш результат открытых весов 4k, 16:9 имел 5472 x 3072 пикселя; единой ширины метка не задаёт.
Инструкция вокруг ролей источников
Начните с триггера, затем назовите перерисовываемое и сохраняемое. Этюд гавани: «Studio1939 style, перерисуй <Picture 1> как чёрно-белую мультяшную гавань с гибкими формами, улыбающимися лодками и округлыми контурами; сохрани расположение городского силуэта». Передайте соответствующий файл в loras: одной фразы недостаточно.
Дополнительная картинка
Для смены сцены назовите оба источника: «Помести женщину сорока с лишним лет из <Picture 1> в гостиную из <Picture 2>, в тёмно-синем платье у тёплой лампы; сохрани узнаваемость». При подключённом VHS триггер может предшествовать инструкции. Это предлагаемое задание, а не утверждение о проверке именно этой сцены.
Разделяйте изменения и сохранение:
- Укажите картинку, дающую человека или предмет.
- Опишите новую одежду, окружение и свет.
- Назовите лицо, позу или расположение, которые должны остаться узнаваемыми.
- После правки сравните эти детали с источниками.
Данные наших правок
Проверенная мультяшная LoRA видеомодели H3 сработала и здесь. Фотография получила рисунок мультфильмов 1930-х с гибкими линиями и сохранением позы. В гавани сохранился городской силуэт, а порт и лодки стали чёрно-белым мультфильмом.
Отдельные правки H3-Image сохраняли лицо при смене одежды и места, а композиция двух картинок переносила героя в другую сцену. Это поддерживает попытки работы с референсами, но не доказывает сохранение каждой личности и композиции с адаптером. Сравнение VHS с подключением и без также меняло композицию: фиксированный seed помогает сравнению, но не гарантирует одинаковый результат.
Файлы, артефакты и устранение ошибок
URL Hugging Face /resolve/main/ должен вести к самому .safetensors. У каждого файла свой scale, исходное значение 1. Сначала оцените один файл, затем смесь; при настройке scale сохраняйте промпт, порядок источников и seed.
Неработающая ссылка вернула Failed to load LoRA без картинки и платы. Проверьте скачивание нужных весов, затем повторите с исправленной ссылкой. Ошибка задачи не подменяет результат необработанной картинкой. Проверяйте и обучающие надписи: VHS-закусочная перенесла vh5tape в угол, поэтому слова важны и для стилизованных правок.
Оплата и выбор другого эндпоинта
Готовая правка оплачивается по уровню плюс фиксированная надбавка LoRA. Каждый референс после исходника доплачивается. Надбавка одинакова для нуля, одного и трёх LoRA; png или webp вместо jpeg цену не меняют. Текущие тарифы — на странице модели; неудачные запросы бесплатны.
Open Weights подходит для правки без адаптеров с seed и пятью уровнями. Для десяти–шестнадцати входов MiniMax H3-Image принимает до шестнадцати; её поведение пропорций и три уровня отличаются, seed нет. Для описания без источника выберите text-to-image этого семейства. Прежняя H3 Image LoRA создаёт кадры видеомоделью и требует отдельной оценки.
Данные содержания тоже ограничены: запросы вернули картинки без отказов, но все правки Very strong стандартного теста были смягчены. Выдача изображения не устанавливает выполнение каждой инструкции.
Быстрый старт 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/edit",
"input": {
"image_urls": [
"https://example.com/reference.png"
],
"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.

























