MiniMax H3 Image API: generowanie, edycja i rzeczywiste ceny

Ceny tego samego modelu u dostawców: Cheap MiniMax H3 Image API · 2026-11-13

Możliwości MiniMax H3 Image i limity hostowanego API

Najmocniejszym argumentem za H3 Image jest jego zunifikowany proces generowania i edycji: opisz nowy zasób, dostarcz referencje produktu lub postaci, a następnie poproś o konkretną zmianę. MiniMax publikuje też wagi do wdrożenia lokalnego. Deklarowane możliwości nie stanowią gwarancji dokładnego odwzorowania logotypów, typografii czy tożsamości w każdym wyniku.

Funkcja hostowanego API	Udokumentowany kontrakt
Generowanie	POST /v1/images/generations
Edycja	POST /v1/images/edits, 1–16 obrazów referencyjnych
Prompt	Do 32 000 znaków; bez ulepszania uwzględnianych jest tylko około pierwszych 4096 tokenów
Wymiary wyjścia	655 360–20 000 000 pikseli; proporcje od 1:3 do 3:1
Liczba wyników	n od 1 do 10
Formaty	Domyślnie JPEG; obsługiwane PNG lub WebP
Odpowiedzi	URL lub Base64 bez streamowania; natywne SSE
Nieobsługiwane opcje	Edycja z maską, przezroczyste tła i obrazy podglądowe

Pliki referencyjne muszą spełniać limity wejściowe MiniMax: JPG/JPEG, PNG, WebP, HEIC lub HEIF, każdy wymiar od 128 do 8192 pikseli, stosunek dłuższego boku do krótszego najwyżej 4:1, a łączne ciało żądania najwyżej 64 MiB. Base64 zwiększa rozmiar żądania. Używaj dostępnych URL-i obrazów lub odpowiednio przygotowanych plików; możliwość przyjęcia 16 obrazów nie znosi limitu rozmiaru ciała żądania.

„4K” w tym API to ustawienie obszaru. area: "4K" docelowo oznacza około 4096 × 4096 pikseli, a wymiary wynikają z proporcji. Przy 16:9 udokumentowane wyjście to 5472 × 3072, a nie 4096 × 2304. Aby podać jawne wymiary, wyślij size: "WIDTHxHEIGHT" i pomiń area oraz aspect_ratio. W przypadku ustalania rozmiaru przez obszar użyj size: "auto", area i aspect_ratio. Sprawdź data[].size oraz rzeczywiste wymiary pobranego obrazu.

Ile kosztuje MiniMax H3 Image?

Dla aktualnej trasy Standard w APIMaster wyliczenie według ceny standardowej wygląda następująco:

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

Używaj osobnych pól zużycia dla tekstu i obrazów; nie naliczaj wszystkich tokenów wejściowych jako tekstu, a następnie ponownie jako wejście obrazu. Ulepszanie promptu generuje rozliczane tokeny tekstowe, więc sama rozdzielczość nie określa całkowitej ceny. Współczynniki przypisane do konkretnego konta, jeśli mają zastosowanie, oraz zaokrąglenia rozliczeniowe mogą wpłynąć na ostateczne obciążenie.

Oficjalne przykładowe sumy dla wariantu Standard pokazują skalę rachunku w MiniMax. To przykłady, a nie stałe taryfy APIMaster ani nasza zmierzona średnia:

Zadanie	1K: 1024 × 1024	2K: 2048 × 2048	4K: 4096 × 4096, stawka standardowa
Generowanie z tekstu	$0.02179	$0.02333	$0.06879
Edycja z jednym obrazem referencyjnym 1K	$0.02654	$0.02658	$0.07312
Edycja z trzema obrazami referencyjnymi 1K	$0.03563	$0.04177	$0.07914

Dla kontekstu: 1000 żądań text-to-image według pierwszego przykładu to około $21.79; jest to przykładowe wyliczenie budżetu tokenowego, a nie pakiet przedpłacony. Rzeczywiste prompty i ulepszanie mogą to zmienić. Nano Banana 2.1 ma inny kontrakt APIMaster oparty na rozdzielczości, zaczynający się od $15.12 za 1000 obrazów 1K, przed wszelkimi warunkami wycenianymi osobno.

Czy oficjalna promocja 50% na 4K obowiązuje w APIMaster?

Nie zakładaj, że obowiązuje. MiniMax reklamuje 50% zniżki na całkowity koszt żądania dla wariantów Standard i Highspeed do 17 listopada 2026 r., 16:00 UTC (wyłącznie) — 18 listopada o 00:00 czasu pekińskiego — gdy finalnie dostarczony obraz ma co najmniej 16 600 000 pikseli. Jego kwadratowy przykład text-to-image w 4K zmienia się w trakcie tej oferty z $0.06879 na $0.03439.

Wyjście 4096 × 4096 kwalifikuje się pod względem obszaru; 4096 × 2304 już nie. Sama etykieta „4K” nie wystarcza. Aktualna trasa publiczna APIMaster korzysta ze standardowych stawek tokenowych, bez tej tymczasowej promocji. Porównuj rzeczywisty kontrakt płatności i zużycia, a nie nagłówek kampanii MiniMax. Po upływie terminu przykłady promocyjne nie powinny być używane jako bieżące ceny.

Przykład API MiniMax H3 Image: generowanie z tekstu

Załóż konto APIMaster, zasil saldo dla płatnych żądań obrazów, a następnie utwórz klucz w sekcji Klucze API. Ustaw APIMASTER_API_KEY w swoim środowisku. Ten przykład używa dokładnego, rozróżniającego wielkość liter identyfikatora modelu z trasy 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"))

To przykład żądania, a nie benchmark jakości obrazu. Pobieraj udane URL-e wyjściowe niezwłocznie i przechowuj pliki u siebie. Sprawdzaj błędy poszczególnych obrazów: przy n > 1 odpowiedź HTTP 200 może zawierać nieudane obrazy. Przekroczenie limitu czasu nie dowodzi odrzucenia żądania. Generowanie w H3 nie jest idempotentne, więc automatyczne ponowienie może utworzyć kolejne płatne generowanie. Jeśli korzystasz z OpenAI SDK, ustaw wystarczająco długi timeout oraz max_retries=0.

Edycja w MiniMax H3 Image: obrazy referencyjne i kontrola promptu

W edycji przez JSON wysyłaj URL-e referencji w images[].image_url. Nie kopiuj pola image_urls z Nano Banana do tego żądania H3. Zastąp przykładowe URL-e własnymi dostępnymi zasobami:

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())

Dotychczasowe testy akceptacyjne integracji APIMaster z 11 listopada obejmowały referencje HTTP, URI danych, wysyłanie multipart, edycję z wieloma referencjami, SSE oraz zdekodowane wyjścia 1K/2K/4K. Kontrolowany test z dwiema referencjami zachował cztery kolorowe kształty i dwie krótkie etykiety. Były to sprawdzenia interfejsu i rozliczeń na prostych zasobach, a nie szeroka ocena fotograficzna czy typograficzna; nie dowodzą wyższości nad innym modelem.

Generowanie domyślnie korzysta z ulepszania promptu; możesz je wyłączyć przez disable_prompt_enhanced: true, podając stałe wymiary lub stałe proporcje. Edycje zawsze korzystają z ulepszania. Sprawdzaj revised_prompt, diagnozując nieoczekiwane zmiany. W pracy nad produktami określ, co musi pozostać niezmienione, wskaż rolę każdej referencji i zweryfikuj wyrenderowaną etykietę przed publikacją.

Standard vs Highspeed oraz otwarte wagi a hostowane API

Highspeed używa tych samych udokumentowanych parametrów API, ale jego oficjalne stawki za wejście obrazu i wyjście obrazu są dwa razy wyższe niż w wariancie Standard; wejście tekstu pozostaje na poziomie $2.30/M. APIMaster obecnie udostępnia wyłącznie wariant Standard. Deklaracje MiniMax dotyczące szybkości na starcie zależą od wariantu modelu, rozmiaru i wdrożenia i nie stanowią zmierzonej gwarancji opóźnień w APIMaster.

Oficjalne repozytorium Hugging Face udostępnia wagi i integracje, w tym Diffusers, SGLang, vLLM-Omni i ComfyUI. Jego checkpoint BF16 ma około 68.65 GB, a osobny enkoder tekstu około 66.7 GB. Rozmiar do pobrania nie jest pełnym szacunkiem pamięci GPU. Lokalne wagi podlegają licencji społecznościowej MiniMax H3 Image, więc zapoznaj się z nią przed wdrożeniem; „otwarte wagi” nie oznaczają nieograniczonego użycia na licencji MIT lub Apache.

Dostęp hostowany służy do oceny promptów bez budowania infrastruktury inferencyjnej. Wdrożenie lokalne rozważ wtedy, gdy kontrola nad inferencją uzasadnia pracę z GPU, utrzymanie i kwestie licencyjne. Limity lokalnego pipeline'u i hostowanego API to różne kontrakty.

FAQ

Czy MiniMax H3 Image to to samo co wideo MiniMax H3?

Nie. H3 Image generuje i edytuje obrazy statyczne za pomocą MiniMax-H3-Image. Rodzina modeli wideo H3 ma inne identyfikatory modeli, endpointy i rozliczanie. Zobacz osobny przewodnik po MiniMax H3 video.

Czy MiniMax H3 Image jest dostępny w APIMaster?

Tak. Sprawdzenie z 13 listopada wykazało jedną włączoną trasę publiczną Standard, rozliczaną według $2.30/M tokenów wejściowych tekstu, $1.50/M tokenów wejściowych obrazu i $3.80/M tokenów wyjściowych obrazu. Highspeed nie miał trasy publicznej. Przed wysłaniem żądań sprawdź aktywną kartę modelu.

Czy H3 Image to API ze stałą ceną $0.02 za obraz?

Nie. Oficjalne przykłady cen za obraz to sumy ilustracyjne. O rzeczywistym rachunku decydują faktyczne zużycie tokenów, ulepszanie promptu, obrazy wejściowe referencyjne i wymiary wyjścia. Aktualna trasa APIMaster korzysta ze standardowego wzoru tokenowego.

Czy H3 Image potrafi edytować z 16 referencjami lub maską?

Dokumentuje obsługę do 16 obrazów referencyjnych w granicach limitów formatu i rozmiaru żądania. Edycja z maską i przezroczyste tła nie są obsługiwane. Instrukcje oparte na referencjach nie gwarantują zachowania zgodności co do piksela.

Co jest tańsze: H3 Image czy Nano Banana 2.1?

Dla zilustrowanego zadania text-to-image w 1K standardowy oficjalny przykład H3 to $0.02179, podczas gdy Nano Banana 2.1 w APIMaster kosztuje od $0.01512 za obraz 1K. Porównanie zestawia przykładową sumę tokenów z wyceną opartą na rozdzielczości; zmierz rzeczywisty koszt akceptowanych wyników dla swoich promptów. Zobacz dedykowane porównanie.

Źródła i kolejne kroki

Źródła sprawdzone 13 listopada 2026 r.: wydanie MiniMax, przewodnik po hostowanym API, oficjalny cennik i promocja, wagi modelu i licencja, cennik obrazów Google oraz aktywne karty rynkowe APIMaster. Opisy możliwości pochodzą od ich odpowiednich dostawców; weryfikacja cen i datowane obserwacje integracji APIMaster są oznaczone osobno.

Otwórz kartę H3 Image, zarejestruj się, utwórz klucz API i wyślij MiniMax-H3-Image do https://apimaster.ai/v1. Aby rozważyć tańszą alternatywę z innym kontraktem rozliczeniowym, porównaj trasy Nano Banana 2.1, obecnie do 55% poniżej referencyjnej ceny wyjścia obrazu Google.