Введение
Загрузите исходные картинки и опишите, что сохранить, добавить или перекрасить, разделяя их роли обозначениями image 1 и image 2.
| Характеристика | Значение |
|---|---|
| Ввод | Изображение |
| Вывод | Изображение |
| Издатель и модель | MiniMax; H3-Image для статичных изображений и правок по референсам |
| Обязательный промпт | Подробное описание на английском до 5 000 символов |
| Уровни разрешения | 1k (по умолчанию, около 1 МП), 2k (около 4 МП), 4k (около 16 МП) |
| Правило цены генерации | 1k и 2k по одному тарифу; 4k втрое дороже |
| Пропорции холста | 15 вариантов от 3:1 до 1:3, включая 1:1, 16:9, 9:16, 21:9 и 4:5, или собственные ширина и высота в пикселях |
| Кодирование результата | По умолчанию PNG; также JPEG и WebP; формат не влияет на цену |
| Входы редактирования | 1–16 картинок; обозначайте image 1, image 2 и далее по порядку |
| Входные форматы | JPEG, PNG, WebP, HEIC и HEIF |
| Размеры исходников | Каждая сторона 128–8192 пикселя; длинная не более четырёх коротких |
| Форма без настройки | Text-to-image: 1:1; правка: модель выбирает по референсам и промпту |
| Отсутствующие настройки | негативный промпт, guidance и шаги сэмплирования |
| Измеренные размеры | 1k 1:1: 1024 x 1024; 2k 16:9: 2720 x 1536; 4k 1:1: 4096 x 4096; 4k 16:9: 5472 x 3072 |
Ключевые возможности и особенности
Room 1207 как часть сцены
Результат 2k, 3:2 показывает женщину в чёрной шёлковой комбинации на гостиничных простынях с запиской «Room 1207, midnight». Слова читаются в фотографической сцене с мягким утренним светом. Здесь можно оценить короткую рукописную строку; надёжность длинных текстов пример не устанавливает.
Надпись в клубной сцене
Наша клубная картинка содержит читаемую вывеску MIDNIGHT JAZZ, а отдельный тест духов — NOIR 07 на этикетке. Это короткие фразы внутри сцены. Собственный текст заключайте в кавычки, указывайте поверхность, затем проверяйте буквы по отдельности.
Разделите задачи комнаты и героя
В обставленной комнате назначение двух референсов понятно: один даёт пространство, другой — собаку. Композиционные тесты успешно переносили предмет или человека в другую сцену. Называйте источники по порядку и объясняйте, какие части окружения оставить.
Изменение вокруг исходного предмета
Пример кеда сочетает новую расцветку с сохранением формы и пола. Стройте предметную правку по принципу изменения и сохранения. После генерации сравните предмет с оригиналом: просьба сохранить деталь — цель проверки, а не гарантия неизменности.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Обязательная инструкция по редактированию до 5 000 символов; обозначайте загруженные картинки как image 1, image 2 и далее по порядку. Готового текста и доплаты за промпт нет. Не менее 1 символов · Не более 5000 символов |
image_urls | Да | Обязательный список из 1–16 картинок JPEG, PNG, WebP, HEIC или HEIF; каждая сторона — 128–8192 пикселя, длинная не более чем вчетверо больше короткой. Не менее 1 элементов · Не более 16 элементов |
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, а также custom, чтобы прямо задать ширину и высоту правки; без этого поля модель выбирает… |
width | Нет | Ширина результата в пикселях при |
height | Нет | Высота результата в пикселях при |
resolution | Нет | Выберите 1k (по умолчанию, около 1 МП), 2k (около 4 МП) или 4k (около 16 МП) для правки. Первые два стоят одинаково; генерация 4k втрое дороже. |
enable_prompt_expansion | Нет | По умолчанию true: перед работой с картинками MiniMax переписывает инструкцию правки на более подробном английском. По умолчанию: |
output_format | Нет | Отредактированный файл может быть png, jpeg или webp; если формат не задан, используется png. Доплата за формат отсутствует. |
seed | Нет | Необязательно, 0–2 147 483 647, бесплатно. |
Стоимость
Правка оплачивается за полученное изображение по выбранному уровню с небольшой доплатой за каждый исходник. Цена генерации 1k и 2k одинакова; 4k стоит втрое дороже, а неудачные правки не оплачиваются.
| Спецификация | Стоимость |
|---|---|
| $0.036 / изображение |
| $0.036 / изображение |
| $0.108 / изображение |
Сценарии использования
Портреты вокруг записки
Опишите героя, тихую комнату и точные слова на карточке. В Room 1207 рукописное сообщение получилось читаемым при 2k и 3:2: это отправная точка для сцен, где слова важны наравне с позой и светом.
Короткие товарные этикетки
Сделайте текст кратким и привяжите к поверхности, например этикетке флакона. В NOIR 07 буквы читались; в MIDNIGHT JAZZ вывеска тоже была чёткой. Эти наблюдения поддерживают проверку короткого текста, а не страницы прозы внутри картинки.
Правки одежды и обстановки
Загрузите разрешённый портрет и опишите другую одежду или место, отдельно попросив сохранить человека. Правки одного исходника сохраняли узнаваемость лица. Проверяйте результат перед принятием его как продолжения оригинала.
Герой в новой сцене
Один источник используйте для человека или предмета, другой — для окружения. В наших композициях из двух картинок это успешно сочеталось. Номера загрузок позволяют указать переносимого героя и принимающую сцену.
Широкие и квадратные композиции
Подберите форму под место использования, затем отдельно разрешение. Мы измерили 2720 x 1536 при 2k, 16:9; 4096 x 4096 при 4k, 1:1; 5472 x 3072 при 4k, 16:9. Уровень не задаёт единственную ширину.
Руководство по промптам и практические советы
Выберите генерацию или редактирование
Для сцены в словах начните с text-to-image, а для результата по готовым картинкам — с image-to-image. Используйте разрешённые фотографии совершеннолетних и не имитируйте чужую личность.
Опишите нужную картинку
Напишите связный английский текст о герое, одежде, настроении, обстановке и свете до 5 000 символов. При правке назовите image 1, image 2 и следующие загрузки, затем изменения и сохраняемые детали.
Настройте форму, размер и файл
Выберите одни из пятнадцати пропорций и 1k, 2k или 4k; 1k и 2k имеют общую цену, 4k втрое дороже. По умолчанию — PNG; JPEG и WebP доступны по тому же тарифу без зависимости от формата.
Проверьте полученные детали
Сверьте надписи с промптом, лица и предметы — с исходниками. Сохраните выбранную картинку и настройки, прежде чем менять часть инструкции для следующего запуска.
Правка и сочетание исходных картинок
MiniMax H3-Image image-to-image принимает инструкцию и от одного до шестнадцати изображений. Один источник может дать сохраняемого человека или предмет, другой — новую сцену. В наших одиночных правках менялись одежда и место при узнаваемом лице; парные тесты соединяли героя одной картинки с окружением другой.
Используйте фотографии, на которые у вас есть права. Люди в исходниках должны быть совершеннолетними; имитация чужой личности недопустима. До принятия портретной правки проверьте узнаваемость и детали источника.
Настройки редактирования
| Параметр | Требование или вариант |
|---|---|
prompt | Обязательная инструкция до 5 000 символов; называйте входы по номеру загрузки |
image_urls | Обязательный упорядоченный список из 1–16 картинок; за каждую есть доплата |
aspect_ratio | Необязательный выбор из пятнадцати пропорций; без него модель выбирает по входам и промпту |
resolution | По умолчанию 1k; доступны также 2k и 4k |
output_format | По умолчанию png, также jpeg и webp; кодирование не меняет цену |
seed | Необязательно, 0–2 147 483 647; при выключенном расширении помогает проверить изменённую инструкцию на тех же исходниках |
enable_prompt_expansion | По умолчанию true; false передаёт инструкцию правки в MiniMax без переписывания |
width, height | Точный размер результата в пикселях при aspect_ratio = custom; нужны оба, в пределах выбранного уровня |
Исходники могут быть JPEG, PNG, WebP, HEIC или HEIF. Стороны — от 128 до 8192 пикселей; длинная не превышает короткую более чем вчетверо. До отправки набора сверьте каждый вход с ограничениями.
Пропорции выхода: 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. Выбирайте их под конкретное место размещения. Без настройки холст выбирает модель; портретный источник не гарантирует сохранения пропорций. Наша правка одного портрета без пропорций вернула 832 x 1248. Вариант custom заменяет пропорции точным размером в пикселях через width и height, например 1024 x 1536 для вертикального макета под печать.
Назначьте источникам роли словами
Пишите image 1 для первой загрузки, image 2 для следующей и далее по фактическому порядку. Количество референсов само не объясняет их взаимодействие. Перед описанием результата назовите исходного героя, новое окружение и сохраняемые детали.
Для композиции можно сказать: «Используй комнату из image 1 как обстановку и помести собаку из image 2 возле дивана». Портретной правке нужна иная структура: «Сохрани узнаваемость повара из image 1 и перенеси его к дождливому рыночному прилавку». Добавьте одежду и освещение после назначения источника, чтобы требования относились к понятному герою.
Разделяйте изменение и сохранение. Для расцветки задайте цвета ткани, отделки и подошвы, затем исходный силуэт и пол. Для переноса назовите новый фон, затем сохраняемые лицо и одежду. Это требования для оценки результата без гарантии, что всё неупомянутое останется неизменным.
Практический порядок проверки
- Сверьте порядок загрузки с именами в промпте.
- Перед правкой проверьте выбранные пропорции и уровень.
- Сопоставьте полученного героя с его исходником.
- Отдельно оцените размещение, нужные цвета и короткие надписи.
- Храните принятый результат вместе со списком источников для следующих правок.
Стоимость генерации и источников
Правка оплачивается по уровню результата с небольшой доплатой за каждый вход, включая первый. Генерация 1k и 2k равна по цене; компонент генерации 4k втрое дороже. Формат цену не меняет. Проверьте текущую цену на странице модели, прежде чем выбирать число источников. Неудачные правки бесплатны.
Каждой дополнительной картинке нужна задача, например задать окружение или героя. Уберите ненужную до отправки: большой набор сам по себе не сообщает замысел. Входная плата следует числу переданных картинок.
Наблюдения и пределы
В одиночных правках одежды и сцены лицо оставалось узнаваемым. Композиции из двух источников тоже успешно помещали человека или предмет в чужое окружение. Собака в комнате, повар и кед показывают разделение правки на изменения и сохраняемые детали. Примеры не устанавливают сохранение личности в неограниченной цепочке правок.
В тестах коротких надписей были NOIR 07 на флаконе и MIDNIGHT JAZZ на вывеске. Когда правке нужен текст, заключите слова в кавычки, укажите место, затем вычитайте результат. Эти короткие строки не подтверждают точность длинных текстов при редактировании.
Стандартизированные NSFW-тесты вернули изображение на каждый запрос и оплачивали каждую выдачу. Very strong соответствовал 0/3 инструкций, Maximum — 6/6. Разброс ограничивает общие выводы о поведении содержания. Смягчённый результат остаётся выданным изображением; неудачные запросы подчиняются отдельному правилу отсутствия платы.
В этом варианте правки нет полей для негативного промпта, guidance и шагов сэмплирования. Поле seed повторяет исходную точку только при enable_prompt_expansion = false, что позволяет проверить изменённую инструкцию на неизменном наборе исходников, но не обещает идентичной правки. Три уровня задают примерную площадь в пикселях; ширина зависит и от формы. Название уровня не заменяет проверки скачанных размеров.
Когда полезна соседняя версия
Для сцены без исходника используйте text-to-image этого семейства. Если нужны промежуточные размеры, рассмотрите Open Weights: до девяти источников и собственная нотация референсов. Open Weights LoRA добавляет входы LoRA. Совпадение картинок между версиями не проверено; выбирайте по настройкам и нужной вместимости референсов.
Быстрый старт 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/edit",
"input": {
"image_urls": [
"https://example.com/reference.png"
],
"output_format": "png",
"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.




























