Введение
Первый URL задаёт редактируемую картинку; следующие URL добавляют материалы, обозначенные в инструкции как <Picture 2>, <Picture 3> и далее.
| Характеристика | Значение |
|---|---|
| Ввод | Изображение |
| Вывод | Изображение |
| Модель и результат | Открытые веса 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 символов; обозначайте исходник как <Picture 1>, следующие референсы — как . Длина промпта не добавляет плату. Не менее 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, причём каждый следующий уровень стоит дороже. |
output_format | Нет | Сохраните правку в jpeg (по умолчанию), png или webp; цена выбранного уровня одинакова для всех трёх форматов. |
seed | Нет | Необязательный источник случайности для сравнения правок; оставьте поле пустым, если фиксация не нужна. |
Стоимость
Успешная правка оплачивается по выбранному уровню, включая первый исходник; за каждый следующий взимается небольшая доплата. Более высокие уровни дороже, неудачные запросы бесплатны.
| Спецификация | Стоимость |
|---|---|
| $0.024 / изображение |
| $0.042 / изображение |
| $0.06 / изображение |
| $0.132 / изображение |
| $0.204 / изображение |
Сценарии использования
Ночные портреты с заданным настроением
Постройте журнальную сцену вокруг человека, действия и источника света. В примере бассейна на крыше мужчина появился на фоне городских огней и синего свечения воды при 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 начинает с исходной картинки и следует письменному заданию. Поставьте источник первым в image_urls, затем добавьте референсы, если другая картинка должна дать героя, предмет или деталь. В одной правке до девяти изображений: источник и до восьми референсов.
Наша прибрежная композиция добавила велосипедистку и велосипед на дорогу со светло-голубым купе. Осенняя правка использовала один источник, изменив окружение при сохранении велосипедистки. Это разные задания для одних настроек источников.
Параметры правки
| Параметр | Значение для правки | Исходное значение или ограничение |
|---|---|---|
image_urls | URL источника и референсов по порядку | Обязательно; всего 1–9 картинок |
prompt | Изменения, роли и сохраняемые детали | Обязательно; до 5 000 символов |
aspect_ratio | Поддерживаемая форма холста | Без настройки следует источнику |
resolution | 1k, 1.5k, 2k, 3k или 4k | 1k; больший уровень дороже |
output_format | jpeg, png или webp | jpeg; без доплаты за формат |
seed | Необязательный источник случайности для контролируемого сравнения | Идентичный результат не гарантирует |
Доступны 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. Не задавайте aspect_ratio, если форма источника должна направлять правку, или задайте другой кадр. Разрешение выбирайте независимо.
Задача для каждой картинки
Источник — <Picture 1>, следующая загрузка — <Picture 2>, далее по порядку. Используйте токены в промпте и сверяйте номера со списком URL. Общее упоминание «референсов» оставляет вклад источников неясным.
Для композиции разделите роли: «Сохрани прибрежную дорогу и купе из <Picture 1>. Добавь женщину тридцати с лишним лет и её велосипед из <Picture 2> рядом с припаркованной машиной. Согласуй дневной свет, сохрани узнаваемость и джинсовую куртку». Окружение, добавляемый герой и сохранение получают отдельные части задания.
Используйте только разрешённые фотографии. Люди во входах должны быть совершеннолетними; не имитируйте чужую личность. Примеры промптов здесь описывают людей от тридцати лет.
Опишите изменение и сохраняемые детали
При смене сезона или места назовите то, что остаётся: человек, причёска, одежда, велосипед. Затем опишите новое окружение и свет. Точечная инструкция может сохранить велосипедистку на каменном мосту, добавив осенние листья, золотистое утро и туманную реку. После правки проверьте узнаваемость и важные предметы.
Если другой референс даёт предмет, назовите его вместе с номером и укажите место. Заполнять все доступные слоты не нужно. Добавляйте картинку, когда её вклад можно назвать в инструкции.
Seed для сравнения одной перемены
Сохраняйте seed, порядок входов, пропорции и уровень, меняя одну часть, например сезон или направление света. Храните список входов и текст с результатом, чтобы понимать разницу запросов. Seed фиксирует источник случайности для сравнения, но не устанавливает одинаковые пиксели или сохранение каждой детали.
Что установили проверки редактирования
Два референса поместили велосипедистку и велосипед возле светло-голубого купе, сохранив дорожную сцену источника. В осеннем примере с одной картинкой сохранились велосипедистка и велосипед, появились оранжевые листья, золотистый свет и речной туман. Тесты одежды и места также сохраняли лицо. Это отдельные наблюдения: каждый новый результат сверяйте с его источниками.
Записанные результаты NSFW
Вечерние проверки правок 11 ноября вернули изображение на каждый запрос без отказов; все выдачи оплачивались. Соответствие заданию: Mild 3/3, Moderate 2/3, Strong 2/3, Very strong 0/3, Maximum 6/6. Остальные результаты были смягчены. Получение картинки отличается от исполнения всех частей запроса; выборка не предсказывает каждую следующую правку.
Расчёт стоимости правки
Тариф за картинку определяется уровнем результата и включает исходник. Каждый последующий вход немного увеличивает плату. У пяти уровней разные тарифы, растущие с размером; смена JPEG, PNG и WebP не меняет цену выбранного уровня. Неудачные запросы не оплачиваются. Посмотрите актуальные цены на странице модели и проверьте число входов перед композицией.
Пределы и альтернативы
Негативного промпта, guidance и шагов сэмплирования здесь нет. Лимит — девять картинок, результат статичен, без видео или звука. Удачная правка не гарантирует идеального совпадения лица, формы предмета или надписи; рассмотрите детали задания.
Для генерации без источника используйте текст в изображение. Версия LoRA добавляет до трёх файлов стилевых весов. Для десяти–шестнадцати картинок рассмотрите MiniMax H3-Image: её настройки используют image 1, image 2 и порядок загрузки вместо этих токенов. Там нет seed, эквивалентность результатов не установлена. P-H3-Image — другая модель; совпадающие промпт и seed не делают результаты взаимозаменяемыми.
Быстрый старт 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/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.

























