MiniMax H3 Image API: генерація, редагування та реальні ціни

Ціни однієї моделі в різних провайдерів: Cheap MiniMax H3 Image API · 2026-11-13

Можливості MiniMax H3 Image та обмеження хостингового API

Найвагоміша причина розглянути H3 Image — уніфікований робочий процес генерації та редагування: опишіть новий об'єкт, надайте референси продукту чи персонажа, а потім попросіть точкову зміну. MiniMax також публікує ваги для локального розгортання. Заявлені можливості не гарантують точного відтворення логотипів, типографіки чи збереження ідентичності в кожному результаті.

Функція хостингового API	Задокументований контракт
Генерація	POST /v1/images/generations
Редагування	POST /v1/images/edits, 1–16 референсних зображень
Промпт	До 32 000 символів; без покращення фактично враховуються лише приблизно перші 4 096 токенів
Розміри виводу	655 360–20 000 000 пікселів; співвідношення сторін від 1:3 до 3:1
Кількість зображень	n від 1 до 10
Формати	JPEG за замовчуванням; підтримуються PNG або WebP
Відповіді	URL або Base64 без потокової передачі; підтримується нативний SSE
Непідтримувані параметри	Редагування з маскою, прозорий фон і попередні зображення

Референсні файли мають відповідати обмеженням вводу MiniMax: JPG/JPEG, PNG, WebP, HEIC або HEIF, кожен вимір 128–8 192 пікселів, співвідношення довгої сторони до короткої не більше 4:1, а загальний розмір тіла запиту — не більше 64 MiB. Base64 збільшує розмір запиту. Використовуйте доступні URL зображень або завантаження відповідного розміру; здатність моделі приймати 16 зображень не скасовує обмеження на розмір тіла запиту.

«4K» у цьому API — це налаштування площі. area: "4K" орієнтується приблизно на 4096 × 4096 пікселів, а розміри виводяться зі співвідношення сторін. За 16:9 задокументований вивід — 5472 × 3072, а не 4096 × 2304. Для явних розмірів надішліть size: "WIDTHxHEIGHT" і пропустіть area та aspect_ratio. Для визначення розміру за площею використовуйте size: "auto", area та aspect_ratio. Перевіряйте data[].size і фактичні розміри завантаженого зображення.

Скільки коштує MiniMax H3 Image?

Для поточного маршруту Standard на APIMaster розрахунок за звичайною ціною такий:

USD = (text_input_tokens × 2.30
     + image_input_tokens × 1.50
     + image_output_tokens × 3.80) / 1,000,000

Використовуйте окремі поля використання для тексту та зображень; не рахуйте всі вхідні токени як текстові, а потім не додавайте ввід зображень ще раз. Покращення промпту додає платні текстові токени, тому сама лише роздільність не визначає загальну ціну. Коефіцієнти для конкретного акаунта, де вони застосовуються, та округлення під час тарифікації можуть вплинути на підсумкове списання.

Офіційні ілюстративні підсумки для Standard від MiniMax показують масштаб рахунку. Це приклади, а не фіксовані тарифи APIMaster чи наші виміряні середні показники:

Завдання	1K: 1024 × 1024	2K: 2048 × 2048	4K: 4096 × 4096, звичайний тариф
Генерація з тексту	$0.02179	$0.02333	$0.06879
Редагування з одним референсом 1K	$0.02654	$0.02658	$0.07312
Редагування з трьома референсами 1K	$0.03563	$0.04177	$0.07914

Для контексту: 1 000 запитів text-to-image за першим прикладом коштували б приблизно $21.79; це ілюстративний розрахунок бюджету токенів, а не передплачений пакет. Фактичні промпти та покращення можуть це змінити. Nano Banana 2.1 має інший контракт APIMaster, заснований на роздільності, з ціною від $15.12 за 1 000 зображень 1K, не враховуючи будь-які окремо обумовлені умови.

Чи діє на APIMaster офіційна акція 50% на 4K?

Не припускайте, що діє. MiniMax рекламує знижку 50% на загальну вартість запиту для Standard і Highspeed до 17 листопада 2026 року, 16:00 UTC, не включно — 18 листопада о 00:00 за пекінським часом — коли фінальне доставлене зображення має щонайменше 16 600 000 пікселів. Її приклад квадратного 4K text-to-image протягом цієї акції змінюється з $0.06879 на $0.03439.

Вивід 4096 × 4096 підходить за площею; 4096 × 2304 — ні. Самого лише позначення «4K» недостатньо. Поточний публічний маршрут APIMaster використовує звичайні тарифи на токени, без цієї тимчасової акції. Порівнюйте фактичний контракт на оплату/використання, а не заголовок кампанії MiniMax. Після закінчення строку акційні приклади не слід використовувати як поточні ціни.

Приклад API MiniMax H3 Image: генерація з тексту

Створіть акаунт APIMaster, поповніть баланс для платних запитів на зображення, а потім створіть ключ у розділі API keys. Задайте APIMASTER_API_KEY у вашому середовищі. У цьому прикладі використовується точний, чутливий до регістру ID моделі маршруту Standard:

import os
import requests

base_url = "https://apimaster.ai/v1"
headers = {"Authorization": f"Bearer {os.environ['APIMASTER_API_KEY']}"}
response = requests.post(
    f"{base_url}/images/generations",
    headers=headers,
    json={
        "model": "MiniMax-H3-Image",
        "prompt": "A studio product photo of a matte blue teapot and two pears on a cream table, soft daylight, no text.",
        "size": "auto",
        "aspect_ratio": "16:9",
        "area": "2K",
        "n": 1,
        "response_format": "url",
    },
    timeout=600,
)
response.raise_for_status()
result = response.json()
for item in result.get("data", []):
    if item.get("error"):
        print("Image failed:", item["error"])
    else:
        print(item.get("url"), item.get("size"))
print("Usage:", result.get("usage"))

Це приклад запиту, а не оцінка якості зображень. Своєчасно завантажуйте URL успішного виводу й зберігайте файли самостійно. Перевіряйте помилки для кожного зображення: за n > 1 відповідь HTTP 200 може містити невдалі зображення. Тайм-аут не доводить, що запит було відхилено. Генерація H3 не є ідемпотентною, тому автоматичний повторний запит може створити ще одну платну генерацію. Якщо користуєтеся OpenAI SDK, задайте достатньо довгий тайм-аут і max_retries=0.

Редагування в MiniMax H3 Image: референсні зображення та контроль промпту

Для редагування через JSON надсилайте URL референсів у images[].image_url. Не копіюйте поле image_urls з Nano Banana у цей запит H3. Замініть приклади URL на власні доступні ресурси:

edit = requests.post(
    f"{base_url}/images/edits",
    headers=headers,
    json={
        "model": "MiniMax-H3-Image",
        "prompt": "Keep the product shape and label from image 1. Use the background palette from image 2. Do not add text or change the product.",
        "images": [
            {"image_url": "https://example.com/product.png"},
            {"image_url": "https://example.com/palette.png"},
        ],
        "size": "2048x2048",
        "n": 1,
        "response_format": "url",
    },
    timeout=600,
)
edit.raise_for_status()
print(edit.json())

Наявні приймальні перевірки інтеграції APIMaster від 11 листопада охоплювали HTTP-референси, data URI, multipart-завантаження, редагування з кількома референсами, SSE та декодовані виводи 1K/2K/4K. Контрольований тест із двома референсами зберіг чотири кольорові фігури та два короткі підписи. Це були перевірки інтерфейсу та тарифікації на простих ресурсах, а не широке оцінювання фотографій чи типографіки; вони не встановлюють переваги над іншою моделлю.

Генерація за замовчуванням використовує покращення промпту; його можна вимкнути за допомогою disable_prompt_enhanced: true, надаючи фіксовані розміри або фіксоване співвідношення сторін. Редагування завжди використовує покращення. Переглядайте revised_prompt, коли діагностуєте неочікувані зміни. Для роботи з продуктами вкажіть, що має залишитися незмінним, визначте роль кожного референсу й перевіряйте відтворений підпис перед публікацією.

Standard проти Highspeed, і відкриті ваги проти хостингового API

Highspeed використовує ті самі задокументовані параметри API, але його офіційні тарифи на ввід і вивід зображень удвічі вищі за Standard; текстовий ввід залишається $2.30/M. Наразі APIMaster пропонує лише Standard. Заяви MiniMax про швидкість на момент запуску залежать від варіанта моделі, розміру та розгортання і не є виміряною гарантією затримки від APIMaster.

В офіційному репозиторії Hugging Face доступні ваги та інтеграції, зокрема Diffusers, SGLang, vLLM-Omni і ComfyUI. Її контрольна точка BF16 становить близько 68.65 GB, окремо — текстовий енкодер приблизно 66.7 GB. Розмір завантаження не є повною оцінкою обсягу пам'яті GPU. Локальні ваги використовують ліцензію спільноти MiniMax H3 Image, тож ознайомтеся з цією ліцензією перед розгортанням; «відкриті ваги» не означають необмеженого використання за MIT чи Apache.

Використовуйте хостинговий доступ, щоб оцінювати промпти без побудови інфраструктури для інференсу. Розгляньте локальне розгортання, коли контроль над інференсом виправдовує витрати на GPU, обслуговування та ліцензування. Обмеження локального пайплайну та хостингового API — це різні контракти.

FAQ

Чи MiniMax H3 Image — те саме, що MiniMax H3 video?

Ні. H3 Image генерує та редагує нерухомі зображення за допомогою MiniMax-H3-Image. Сімейство H3 video має інші ID моделей, ендпойнти й тарифікацію. Дивіться окремий посібник із MiniMax H3 video.

Чи доступний MiniMax H3 Image на APIMaster?

Так. Перевірка 13 листопада виявила один увімкнений публічний маршрут Standard із тарифікацією $2.30/M за текстовий ввід, $1.50/M за ввід зображень і $3.80/M за вивід зображень. У Highspeed публічного маршруту не було. Перевіряйте актуальну картку моделі перед надсиланням запитів.

Чи H3 Image — API з фіксованою ціною $0.02 за зображення?

Ні. Офіційні приклади ціни за зображення — це ілюстративні підсумки. Фактичне використання токенів, покращення промпту, вхідні референси та розміри виводу визначають рахунок. Поточний маршрут APIMaster використовує звичайну формулу токенів.

Чи може H3 Image редагувати з 16 референсами або маскою?

Вона декларує до 16 референсних зображень у межах обмежень на формат і розмір запиту. Редагування з маскою та прозорий фон не підтримуються. Інструкції на основі референсів не гарантують попіксельно точного збереження.

Що дешевше: H3 Image чи Nano Banana 2.1?

Для проілюстрованого завдання text-to-image 1K звичайний офіційний приклад H3 становить $0.02179, тоді як Nano Banana 2.1 на APIMaster — від $0.01512 за зображення 1K. Тут порівнюється приклад підсумку токенів із ціною за роздільність; вимірюйте фактичну вартість прийнятного виводу для своїх промптів. Дивіться окреме порівняння.

Джерела та подальші кроки

Джерела перевірено 13 листопада 2026 року: реліз MiniMax, посібник із хостингового API, офіційні ціни та акція, ваги моделі та ліцензія, ціни Google на зображення і актуальні ринкові картки APIMaster. Описи можливостей походять від відповідних постачальників; перевірки цін і датовані спостереження щодо інтеграції з APIMaster позначено окремо.

Відкрийте картку H3 Image, зареєструйтеся, створіть API-ключ і надішліть MiniMax-H3-Image на https://apimaster.ai/v1. Для зниженої альтернативи з іншим контрактом тарифікації порівняйте маршрути Nano Banana 2.1, наразі до 55% нижче за орієнтир Google для виводу зображень.