MiniMax H3 Image API
MiniMax H3 Image — модель MiniMax для генерации и редактирования изображений, выпущенная 11 ноября 2026 года. На APIMart она вызывается по идентификатору модели minimax-h3-image: текст в изображение и редактирование по референсным изображениям в 1K, 2K или 4K.
Преимущества сервиса
- Официальные скидки
- Оплата по факту
- Быстро и без задержек
Image link valid for 72 hours
Цены на MiniMax H3 Image API
Прозрачные цены без скрытых комиссий. Платите только за то, что используете.
| Вариант | Уровень | Золотая ценаТекущая цена | Платиновая цена | Бриллиантовая цена | Официальная цена | Ваша экономия |
|---|---|---|---|---|---|---|
minimax-h3-imageЦены являются ориентировочными; фактическая стоимость рассчитывается по токенам. | 1K/2K | 0.1891Credits/изобр~$0.0189/изобр | 0.1797Credits/изобр~$0.018/изобр | 0.1702Credits/изобр~$0.017/изобр | 0.2364Credits/изобр~$0.0236/изобр | 20% |
| 4K | 0.628Credits/изобр~$0.0628/изобр | 0.5966Credits/изобр~$0.0597/изобр | 0.5652Credits/изобр~$0.0565/изобр | 0.785Credits/изобр~$0.0785/изобр | 20% |
* Фактические расходы зависят от конечного результата.
* Оплата по токенам. В таблице — оценка для одного изображения в режиме «текст в изображение»: вывод изображения плюс около 2 000 токенов текстового ввода на расширение промпта. Референсы добавляют токены ввода изображений. Фактическое списание показано в поле cost каждой задачи.
MiniMax H3 Image API: текст в изображение и редактирование изображений до 4K
Генерируйте изображения по промпту или редактируйте, передав до 16 референсных изображений. Выберите 1K, 2K или 4K с любым соотношением сторон от 1:3 до 3:1 либо задайте точный размер в пикселях — до 20 миллионов. Один запрос возвращает до 10 изображений, а встроенное улучшение промпта само разворачивает короткие промпты.
MiniMax H3 Image API: пример для режима «текст в изображение» и редактирования изображений
Вызовите MiniMax H3 Image на APIMart одним POST-запросом. Генерация асинхронная: отправьте задачу, затем опрашивайте эндпоинт задач, чтобы получить URL изображений.
- 1
Авторизуйте запросы к MiniMax H3 Image API
Сохраните API-ключ APIMart в переменной окружения APIMART_API_KEY и отправляйте его как Authorization: Bearer <key> в каждом запросе.
- 2
Отправьте задачу MiniMax H3 Image
Отправьте POST /v1/images/generations с model minimax-h3-image, вашим промптом, size и resolution. Чтобы редактировать по референсным изображениям, добавьте image_urls. ID задачи находится в data[0].task_id.
- 3
Получите сгенерированные изображения
Опрашивайте GET /v1/tasks/{task_id} каждые 3–5 секунд, пока status не станет completed, затем прочитайте URL изображений из data.result.images[0].url. Результаты хранятся 72 часа, поэтому скачайте их вовремя.
Все параметры, правила для размеров и поля ответа описаны здесь: документация MiniMax H3 Image API.
curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3-image",
"prompt": "Уютная кофейня у моря на закате, фотореализм, тёплые тона",
"size": "16:9",
"resolution": "2K"
}'import os
import time
import requests
API_BASE = "https://api.apimart.ai"
headers = {"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}"}
# 1. Submit the generation task
payload = {
"model": "minimax-h3-image",
"prompt": "Уютная кофейня у моря на закате, фотореализм, тёплые тона",
"size": "16:9",
"resolution": "2K"
}
resp = requests.post(f"{API_BASE}/v1/images/generations", headers=headers, json=payload, timeout=60)
resp.raise_for_status()
task_id = resp.json()["data"][0]["task_id"]
# 2. Poll the task until it finishes
for _ in range(200):
task_resp = requests.get(f"{API_BASE}/v1/tasks/{task_id}", headers=headers, timeout=30)
task_resp.raise_for_status()
task = task_resp.json()["data"]
if task["status"] == "completed":
print(task["result"]["images"][0]["url"][0])
break
if task["status"] == "failed":
raise RuntimeError(task.get("error", {}).get("message", "generation failed"))
time.sleep(3)
else:
raise TimeoutError(f"task {task_id} did not finish in time; continue GET polling with this task ID")curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3-image",
"prompt": "Надень куртку со второго изображения на человека с первого изображения, фон оставь без изменений",
"image_urls": [
"https://example.com/person.jpg",
"https://example.com/jacket.png"
],
"resolution": "2K"
}'TASK_ID="task_xxx" # replace with the task_id returned by the POST request
curl "https://api.apimart.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $APIMART_API_KEY"Параметры MiniMax H3 Image API
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
model | string | Да | По умолчанию: minimax-h3-image | Укажите minimax-h3-image. |
prompt | string | Да | По умолчанию: — | Описание изображения, от 1 до 32 000 символов после удаления пробелов по краям. |
size | string | Нет | По умолчанию: auto | auto, соотношение сторон, например 16:9 (от 1:3 до 3:1), или пиксели, например 2048x1152 (всего от 655 360 до 20 000 000 пикселей). |
aspect_ratio | string | Нет | По умолчанию: — | Другой способ передать соотношение сторон, например 16:9. Если задан, имеет приоритет над size. |
resolution | string | Нет | По умолчанию: 4K | 1K, 2K или 4K. Нельзя использовать, когда size задан в пикселях. |
n | integer | Нет | По умолчанию: 1 | Количество изображений, от 1 до 10. |
image_urls | string[] | Нет | По умолчанию: — | До 16 референсных изображений в виде URL или data URI в Base64. При их добавлении включается режим редактирования. |
prompt_optimizer | boolean | Нет | По умолчанию: true | Разворачивает промпт перед генерацией. false работает только для режима «текст в изображение» с явно заданным size. |
output_format | string | Нет | По умолчанию: jpeg | jpeg, png или webp. |
output_compression | integer | Нет | По умолчанию: 95 | Качество сжатия от 0 до 100. Для png игнорируется. |
watermark | boolean | Нет | По умолчанию: false | Добавляет на изображение видимый водяной знак о генерации ИИ. |
