Введение
Отправьте описание сцены и при желании задайте seed, форму изображения, уровень размера и формат файла для генератора с открытыми весами.
| Характеристика | Значение |
|---|---|
| Ввод | Текст |
| Вывод | Изображение |
| Модель и результат | Открытые веса MiniMax H3-Image; генерация по тексту и правка; статичные изображения |
| Предел промпта | Обязателен; до 5 000 символов на обоих эндпоинтах |
| Доступные уровни | 1k ~1 МП (по умолчанию); 1.5k ~2,4 МП; 2k ~4 МП; 3k ~9,4 МП; 4k ~16,8 МП |
| Пропорции кадра | Пятнадцать вариантов: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 5:4, 4:5, 2:1, 1:2, 3:1, 1:3, 21:9, 9:21 |
| Форма по умолчанию | Генерация по тексту: 1:1; правка: форма исходника без |
| Входные картинки | 1–9 изображений: исходник и до восьми референсов |
| Обозначения источников | <Picture 1> — исходник; <Picture 2> и далее — дополнительные референсы |
| seed | Необязателен; помогает сравнить одну правку без гарантии одинаковых пикселей |
| Кодирование файла | jpeg (по умолчанию), png или webp; формат цену не меняет |
| Полученные размеры | 1k 3:4: 896 x 1184; 1.5k 9:16: 1152 x 2048; 2k 3:2: 2496 x 1664; 3k 1:1: 3072 x 3072; 4k 16:9: 5472 x 3072 |
| Наблюдаемая обработка | 11 ноября: 1k — 20–45 секунд утром и 3–6 вечером; 4k — 36 секунд вечером; без очереди и передачи |
| Основа оплаты | За готовую картинку по разрешению; правки добавляют плату за каждый референс после источника; неудачные запросы бесплатны |
Ключевые возможности и особенности
Синий свет бассейна на фоне города
При 1.5k, 3:4 и seed 7 пример показывает мужчину, выходящего ночью из бассейна на крыше, с городскими огнями и синим свечением позади. Это портрет промежуточного уровня рядом с более крупным квадратным завтраком.
Натюрморт на среднем крупном уровне
Завтрак дал вид хлеба, инжира, мёда и льна размером 3072 x 3072 с seed 7.
Добавьте велосипедистку на побережье
Композиция сохранила дорогу и светло-голубое купе из <Picture 1>, поместив рядом велосипедистку и велосипед из <Picture 2>.
Замените пасмурную погоду осенним светом
Одна картинка превратилась в осенний мост с падающими оранжевыми листьями и туманной рекой.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
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; повышение уровня увеличивает цену за изображение. |
output_format | Нет | По умолчанию используется jpeg; форматы png и webp доступны без изменения цены. |
seed | Нет | Необязательный seed сохраняет источник случайности при сравнении одного изменения, не гарантируя тот же результат. |
Стоимость
Успешная генерация оплачивается за изображение по одному из пяти выбранных уровней; каждый следующий уровень дороже предыдущего. Неудачная генерация бесплатна.
| Спецификация | Стоимость |
|---|---|
| $0.024 / изображение |
| $0.036 / изображение |
| $0.048 / изображение |
| $0.096 / изображение |
| $0.144 / изображение |
Сценарии использования
Ночные портреты с заданным настроением
Постройте журнальную сцену вокруг человека, действия и источника света. В примере бассейна на крыше мужчина появился на фоне городских огней и синего свечения воды при 1.5k, 3:4 и seed 7.
Натюрморты на столе в большом размере
Опишите предметы и размещение до выбора уровня. Квадратный завтрак 3k имел 3072 x 3072 и показывал хлеб, инжир, мёд и лён сверху.
Композиции с отдельными ролями источников
Дайте окружению и добавляемому герою разные номера. В прибрежной правке сохранились дорога и светло-голубое купе, а велосипедистка с велосипедом из другого референса появились рядом.
Смена сезона вокруг сохранённого героя
Попросите новый сезон и свет, назвав сохраняемые детали. На мосту остались велосипедистка и велосипед, а вокруг появились осенние листья, золотистый свет и туман над рекой.
Вывески с коротким заданным текстом
Заключите короткую надпись в кавычки и укажите место. В сравнении одинаковых промптов деревянная вывеска верно показывала HOT SOUP 3 FRANCS; длинный текст всё ещё требует тщательной проверки.
Руководство по промптам и практические советы
Начните со сцены или исходника
Для текстового задания выберите генерацию по тексту, для готовой картинки — редактирование. При правке используйте разрешённые фотографии совершеннолетних без имитации личности.
Опишите кадр и роли референсов
Связным английским текстом задайте место, героя, одежду, свет и ракурс. Для правки назовите источник <Picture 1>, каждому следующему референсу назначьте номер и роль.
Выберите форму, уровень и формат
Задайте разрешение от 1k до 4k и пропорции для генерации. Без пропорций правка следует форме источника; по умолчанию JPEG, также доступны PNG и WebP.
Сравните одну правку с seed
Сохраняйте seed и прочие настройки, меняя одну инструкцию. Сверяйте результат с заданием: фиксированный seed помогает сравнению без обещания идентичности.
Генерация кадра по описанию
MiniMax H3-Image Open Weights превращает описание сцены в картинку с пятью уровнями разрешения и необязательным seed. Это вариант для нового портрета, натюрморта на столе или визуального этюда без исходника. Бассейн на крыше использует 1.5k, 3:4 и seed 7; завтрак показывает квадратную композицию 3k.
Параметры и исходные настройки
| Параметр | Что передать | Значение по умолчанию или эффект |
|---|---|---|
prompt | Обязательное описание до 5 000 символов | Опишите весь задуманный кадр |
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 | 1k; каждый следующий уровень дороже |
output_format | jpeg, png или webp | jpeg; формат не меняет тариф |
seed | Необязательный источник случайности для сравнения | Одинаковые пиксели не гарантированы |
Пропорции задают форму кадра, уровень — примерную площадь. Мы измерили 896 x 1184 при 1k 3:4, 1152 x 2048 при 1.5k 9:16, 2496 x 1664 при 2k 3:2, 3072 x 3072 при квадратном 3k и 5472 x 3072 при 4k 16:9. Название уровня не задаёт фиксированную ширину или высоту.
Стоимость перед запуском
Готовая генерация оплачивается за изображение по выбранному разрешению. При переходе от 1k через промежуточные уровни к 4k цена растёт на каждом шаге. Выбирайте JPEG, PNG либо WebP под нужный файл: тариф уровня не меняется. Неудачные генерации не оплачиваются. Перед выбором размера проверьте текущие цены модели.
Опишите изображение связным текстом
По информации MiniMax, H3-Image ожидает подробное английское описание всей картины. Используйте текст целенаправленно: назовите героя, действие, место, свет и ракурс. Для людей задавайте возраст от тридцати лет. Одежда и выражение могут передать настроение без длинного списка разрозненных стилевых тегов.
Например: «Женщина сорока с лишним лет в шёлковом вечернем платье ждёт на крытой террасе после дождя. Тёплый свет из двери освещает её профиль, дальний город синий и туманный, камера снимает всю сцену с другой стороны стола». Отдельно выберите поддерживаемые пропорции под место размещения.
Для текста заключите короткую фразу в кавычки и закрепите за предметом: вывеской, этикеткой флакона или карточкой на столе. Проверьте слова в результате до использования. Наши данные касаются коротких надписей и не подтверждают точность целого абзаца.
Сравнение одной правки
Задайте seed, сохраните пропорции и разрешение, затем измените одну деталь, например направление света. Держите оба промпта рядом с картинками. Фиксированный seed помогает сравнивать по одному изменению, но не обещает идентичности при повторе. Рассматривайте сравнение как визуальное свидетельство, а не попиксельную проверку.
Что дали примеры и тесты
- Пример на крыше показал мужчину, выходящего из бассейна ночью, с огнями города и синим свечением воды. Настройки: 1.5k, 3:4, seed 7, PNG.
- Завтрак показал хлеб, инжир, мёд и лён сверху в композиции 3072 x 3072 на квадратном 3k.
- В сравнении шести промптов на 1k деревянная вывеска верно показывала «HOT SOUP 3 FRANCS». В другом запросе кофейная воронка превратилась в кружку с ручкой: проверять нужно и предметы, и текст.
- 11 ноября работа модели на 1k занимала от 20–45 секунд утром до 3–6 секунд вечером. Вечерний 4k занял 36 секунд. Очередь и передача файла исключены.
Наблюдения тестов содержания
В вечерних NSFW-проверках 11 ноября отказов text-to-image не было, все выданные изображения оплачивались. Число соответствий заданию: Mild 3/3, Moderate 3/3, Strong 3/3, Very strong 1/3, Maximum 6/6. Поэтому часть запросов вернула смягчённые картинки вместо отказа. Метки уровней описывают запись проверок, а не обещают исход будущего запроса.
Ограничения и близкие варианты
Эндпоинт создаёт статичные изображения без видео и звука. Настроек негативного промпта, guidance и шагов сэмплирования нет. Укладывайте промпт в 5 000 символов и сверяйте лица, предметы и надписи с заданием до принятия результата.
Выберите редактирование, когда изменение должно опираться на исходник. Вариант LoRA принимает до трёх добавленных файлов стилевых весов. MiniMax H3-Image даёт три уровня без seed; эквивалентность результатов не проверена. P-H3-Image — отдельная модель, давшая другие изображения при совпадающих входах. Прежнее семейство H3 Image LoRA использует видеомодель H3 для отдельного кадра.
Быстрый старт 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/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k",
"aspect_ratio": "1:1",
"output_format": "jpeg"
}
}'
# 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.
























