Пока это руководство есть только на английском. →
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
aspect_ratio | Нет | Форма кадра: широкая, квадратная или вертикальная. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 9:21 · 2:1 · 1:2 · 3:1 · 1:3 · 5:4 · 4:5 |
image_urls | Да | Фото для правки или объединения. В промпте укажите, что берётся из каждого. |
loras | Нет | Загрузите свои LoRA, чтобы закрепить стиль или персонажа. По умолчанию: [] |
output_format | Нет | Формат файла результата. jpeg · png · webp · По умолчанию: jpeg |
prompt | Да | Say what to change. Refer to the references as <Picture 1>, <Picture 2> and so on. |
resolution | Нет | Размер результата. Больше — чётче и дороже. 1k · 2k · По умолчанию: 1k |
seed | Нет | Одно и то же число даёт повторяемый результат. ≥ 0 · ≤ 2147483647 |
Цены
Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,01). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.
| Вариант | Кредиты за изображение | ≈ USD |
|---|---|---|
| resolution 1K | 8,1 | 0,081 $ |
| resolution 2K | 18,9 | 0,19 $ |
Каждая задача округляется вверх до целых кредитов, поэтому один запуск на самом дешёвом уровне стоит 9 кредитов за изображение (0,09 $).
Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.
Быстрый старт API
Вызов API MiniMax H3 Image LoRA в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
- Отправьте запрос. Отправьте POST /jobs/createTask с model minimax/h3-image-lora/edit и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
- Получите результат. Опрашивайте GET /jobs/recordInfo по ID задачи или передайте callBackUrl — мы отправим результат туда. Когда задача выполнится, скачайте файлы по ссылкам.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "minimax/h3-image-lora/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_urls": [
"https://media.popnow.ai/influencer/examples/marco.webp"
],
"resolution": "1k",
"output_format": "jpeg"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Замените промпт и ссылки на свои. Справка по ответу, опросу статуса и callback есть на вкладке API.
Вопросы об API MiniMax H3 Image LoRA
Сколько стоит API MiniMax H3 Image LoRA?
MiniMax H3 Image LoRA стоит от 9 кредитов (0,09 $) за изображение — на самой дешёвой задаче «Редактировать картинку». Цены по вариантам: 1K 8,1 кредита за изображение, 2K 18,9 кредита за изображение. Кредиты те же, что и на сайте (1 кредит = 0,01 $), новые аккаунты получают 30 бесплатных кредитов, а за неудачные задачи кредиты возвращаются.
Какое имя модели у MiniMax H3 Image LoRA в API?
Укажите minimax/h3-image-lora/text-to-image — Создать картинку; minimax/h3-image-lora/edit — Редактировать картинку в поле model запроса POST /jobs/createTask.
Это отдельная модель изображений?
Нет. Это MiniMax H3, видеомодель, которая генерирует один кадр. Поэтому её кадры выглядят как стоп-кадры из фильма, а ваши видео-LoRA для H3 работают и здесь.
Как передать LoRA?
Записью в массиве loras: прямая HTTPS-ссылка на файл .safetensors, обученный под MiniMax H3, и scale от 0 до 4.
Насколько большие получаются изображения?
1k — около одного мегапикселя (в нашем тесте изображение 3:2 пришло размером 1248 x 832), 2k — около четырёх.
Сохраняет ли редактирование лицо человека?
Да, именно для этого оно и сделано. В нашем тесте результат сохранил лицо и причёску с референса, а поза, одежда и обстановка изменились.
Можно ли получить прозрачный PNG?
Нет. PNG возвращается обычным трёхканальным изображением.
Какие ограничения у API MiniMax H3 Image LoRA?
Разрешения: 1K · 2K; Соотношения сторон: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +9; Референсные изображения: 9; Длина промпта (символов): 5,000; Максимальный размер загрузки: 10 MB. Запросы за пределами этих ограничений отклоняются до любого списания.
Можно попробовать MiniMax H3 Image LoRA без кода?
Да. Playground запускает MiniMax H3 Image LoRA на ваших кредитах PopNow без API-ключа и показывает код для каждой генерации.
Все модели MiniMax
Для движущейся картинки на тех же весах бери MiniMax H3 LoRA.
- MiniMax H3 APIВыразительные клипы со звуком, до 2KОт 28 кредитов за клип длиной 5 с
- MiniMax Speech 2.8 HD APIРечь высокого качества, 400+ голосов и управление эмоциямиОт 18 кредитов за 1000 символов
- MiniMax Music 3.0 APIГотовые стереотреки — с вокалом или инструментальныеОт 27 кредитов за генерацию
- MiniMax H3 Singularity LoRA APIВидео H3 в доработке сообщества, загружает твои LoRAОт 45 кредитов за клип длиной 5 с
- MiniMax H3 Max APIБыстрые клипы с атмосферой, эффектами и музыкойОт 38 кредитов за клип длиной 5 с
- MiniMax H3 LoRA APIВидео MiniMax H3 со звуком и до трёх твоих LoRAОт 38 кредитов за клип длиной 5 с
- MiniMax H3 Image LoRA APIКадры и правки H3 с тремя твоими LoRAОт 7 кредитов за изображение
- MiniMax Speech 2.8 Turbo APIБыстрая речь, 400+ голосов и управление эмоциямиОт 11 кредитов за 1000 символов


