MiniMax H3 Image Highspeed API
MiniMax H3 Image Highspeed to zoptymalizowana pod względem szybkości odmiana modelu MiniMax H3 Image, która generuje i edytuje obrazy z tekstu oraz do 16 obrazów referencyjnych, zachowując te same parametry co wersja standardowa.
MiniMax H3 Image Highspeed to model generatywny firmy MiniMax należący do rodziny H3 Image. Przyjmuje tekst i obrazy jako dane wejściowe, a zwraca obrazy, obsługując zarówno generowanie od zera na podstawie opisu, jak i edycję istniejących zdjęć. W jednej generacji potrafi połączyć do 16 obrazów referencyjnych, co przydaje się przy zachowaniu spójności postaci i tworzeniu złożonych kompozycji z wieloma elementami. Model jest dostępny jako open-weights, więc można uruchomić go lokalnie.
Wersja Highspeed jest 3 do 4 razy szybsza od trybu standardowego, a sam tryb standardowy bywa 1,5 do 2 razy szybszy od niektórych konkurencyjnych modeli. Model generuje obrazy w natywnych rozdzielczościach około 16 megapikseli i obsługuje proporcje od 1:3 do 3:1. Przyjmuje identyczne parametry i limity co wersja standardowa. Dzięki temu sprawdza się w szybkim prototypowaniu, przetwarzaniu wsadowym oraz tworzeniu materiałów marketingowych.
Model dobrze radzi sobie z długimi i gęstymi tekstami w obrazie, dlatego znajduje zastosowanie przy plakatach, infografikach i ekranach interfejsu. Niektóre źródła wskazują jednak ograniczenia: efektywna kompresja przestrzenna 32x może powodować zauważalną utratę ostrości przy pewnych rozdzielczościach, a drobne szczegóły bywają słabiej odwzorowane. Model jest też wymagający sprzętowo ze względu na 32b enkoder tekstu.
Zaktualizowano:
MODEL ID
minimax-h3-image-highspeed- Wejście
- text / image
- Wyjście
- image
Najważniejsze informacje
- 3–4 razy szybszy od trybu standardowego
- Do 16 obrazów referencyjnych
- Natywne rozdzielczości około 16 MP
- Proporcje od 1:3 do 3:1
- Model open-weights
- Obsługa długich i gęstych tekstów
Dostawcy
Porównaj ceny API u różnych dostawców. Wybierz dostawcę, aby zobaczyć wszystkie opłaty i warunki.
| Dostępność | |
|---|---|
Dane historyczne nie są kontrolą na żywo. Brak danych nie oznacza awarii.
Szybki start
Wyślij zadanie obrazu, sprawdzaj stan i zapisz obrazy. Przykłady używają curl i biblioteki standardowej Pythona 3.
POST https://openapi.felo.ai/api/v1/images/generations
1Pobierz klucz API
Utwórz klucz w swoim koncie Felo API Platform i ustaw go jako zmienną środowiskową.
export FELO_API_KEY="YOUR_API_KEY"2Wyślij pierwsze żądanie
Wartości opcjonalne zależą od modelu i nie są tu ustawione. Sprawdź je w Playground. Pola są na tym samym poziomie co model i prompt, bez opakowania input.
curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-o created.json \
-d '{
"prompt": "A studio product photo of a ceramic coffee cup on warm linen, soft morning light",
"model": "minimax-h3-image-highspeed"
}'3Odpytuj zadanie
Odpowiedź zawiera task_id. Sprawdzaj co 3 sekundy przy queued lub running; zakończ przy succeeded, failed lub interrupted. Maksymalny czas: 30 minut. Zachowaj created.json, aby wznowić odpytywanie bez ponownego wysłania.
python3 - <<'PY'
import json, os, time
from pathlib import Path
from urllib.parse import quote
from urllib.request import Request, urlopen
task = json.loads(Path("created.json").read_text())
task_id = task["task_id"]
url = "https://openapi.felo.ai/api/v1/images/generations/" + quote(task_id, safe="")
headers = {"Authorization": "Bearer " + os.environ["FELO_API_KEY"]}
deadline = time.monotonic() + 1800
while task["status"] in ("queued", "running"):
if time.monotonic() >= deadline:
raise TimeoutError(f"Keep task_id={task_id} to resume polling")
time.sleep(3)
with urlopen(Request(url, headers=headers), timeout=60) as response:
task = json.load(response)
if task.get("task_id") != task_id or task.get("kind") != "image":
raise ValueError("Unexpected task response")
print(task["status"])
if task["status"] != "succeeded":
raise RuntimeError(task.get("error") or task["status"])
if not task.get("outputs"):
raise ValueError("Task succeeded without image outputs")
Path("task.json").write_text(json.dumps(task))
print("Saved task.json")
PY4Pobierz wynik
Po sukcesie zapisz outputs z task.json. Obsługiwane są adresy HTTPS, obiekty URL i b64_json. Pobierz podpisane adresy szybko; do pobierania obrazów nie potrzeba klucza API.
python3 - <<'PY'
import base64, json
from pathlib import Path
from urllib.request import urlopen
task = json.loads(Path("task.json").read_text())
if task.get("status") != "succeeded" or not task.get("outputs"):
raise ValueError("No completed image outputs")
extensions = {"image/png": ".png", "image/jpeg": ".jpg", "image/webp": ".webp", "image/gif": ".gif", "image/avif": ".avif"}
for index, output in enumerate(task["outputs"], 1):
item = output if isinstance(output, dict) else {}
url = output if isinstance(output, str) else item.get("url") or item.get("unsigned_url")
mime = item.get("media_type") or "image/png"
if url and url.startswith("https://"):
with urlopen(url, timeout=60) as response:
data = response.read()
mime = response.headers.get_content_type()
elif url and url.startswith("data:image/") and ";base64," in url:
header, encoded = url.split(",", 1)
mime = header[5:].split(";", 1)[0]
data = base64.b64decode(encoded, validate=True)
elif item.get("b64_json"):
data = base64.b64decode(item["b64_json"], validate=True)
else:
raise ValueError("Unrecognized image output")
path = Path(f"image-{index}" + extensions.get(mime, ".bin"))
path.write_bytes(data)
print(path)
PYinput_references
Aby edytować obraz, zastąp przykładowy URL własnym adresem HTTPS lub data URL obrazu base64. Wyślij raz, potem zastosuj te same kroki sprawdzania i zapisywania.
curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-o created.json \
-d '{
"prompt": "Keep the product and framing. Replace the background with a sunlit marble countertop.",
"model": "minimax-h3-image-highspeed",
"input_references": [
{
"type": "image_url",
"image_url": {
"url": "https://example.com/product.png"
}
}
]
}'Obsługiwane parametry
- n
- size
- resolution
- aspect_ratio
- output_format
- input_references
Potrzebujesz pełnej dokumentacji?
Dokumentacja API →Często zadawane pytania
Co to jest MiniMax H3 Image Highspeed?
MiniMax H3 Image Highspeed to model generatywny firmy MiniMax należący do rodziny H3 Image. Przyjmuje tekst i obrazy jako dane wejściowe, a zwraca obrazy, obsługując zarówno generowanie od zera na podstawie opisu, jak i edycję istniejących zdjęć. W jednej generacji potrafi połączyć do 16 obrazów referencyjnych, co przydaje się przy zachowaniu spójności postaci i tworzeniu złożonych kompozycji z wieloma elementami. Model jest dostępny jako open-weights, więc można uruchomić go lokalnie. Wersja Highspeed jest 3 do 4 razy szybsza od trybu standardowego, a sam tryb standardowy bywa 1,5 do 2 razy szybszy od niektórych konkurencyjnych modeli. Model generuje obrazy w natywnych rozdzielczościach około 16 megapikseli i obsługuje proporcje od 1:3 do 3:1. Przyjmuje identyczne parametry i limity co wersja standardowa. Dzięki temu sprawdza się w szybkim prototypowaniu, przetwarzaniu wsadowym oraz tworzeniu materiałów marketingowych. Model dobrze radzi sobie z długimi i gęstymi tekstami w obrazie, dlatego znajduje zastosowanie przy plakatach, infografikach i ekranach interfejsu. Niektóre źródła wskazują jednak ograniczenia: efektywna kompresja przestrzenna 32x może powodować zauważalną utratę ostrości przy pewnych rozdzielczościach, a drobne szczegóły bywają słabiej odwzorowane. Model jest też wymagający sprzętowo ze względu na 32b enkoder tekstu.
Jak rozliczane jest użycie?
Rachunek zależy od wybranego dostawcy, jego cen i faktycznego zużycia. Dłuższe dane wejściowe lub inne warunki mogą mieć inne ceny. Rozliczane według rzeczywistego kosztu generowania. Ostateczną kwotę znajdziesz na rachunku.
Jakie dane wejściowe obsługuje model MiniMax H3 Image Highspeed?
Model przyjmuje tekst i obrazy jako dane wejściowe, a generuje obrazy. Może tworzyć obrazy na podstawie opisu tekstowego oraz edytować istniejące obrazy.
Ile obrazów referencyjnych można połączyć w jednej generacji?
Model potrafi połączyć do 16 obrazów referencyjnych w jednej generacji, co pomaga zachować spójność postaci i tworzyć złożone kompozycje.
Czym różni się wersja Highspeed od standardowej?
Wersja Highspeed jest 3 do 4 razy szybsza od trybu standardowego, ale przyjmuje te same parametry i limity. Tryb standardowy bywa z kolei 1,5 do 2 razy szybszy od niektórych konkurencyjnych modeli.
Do jakich zadań najlepiej nadaje się ten model?
Sprawdza się przy generowaniu obrazów z tekstu, edycji zdjęć, tworzeniu plakatów, infografik, ekranów interfejsu i materiałów marketingowych, a także w szybkim prototypowaniu i przetwarzaniu wsadowym.
Jakie są ograniczenia modelu?
Efektywna kompresja przestrzenna 32x może powodować zauważalną utratę ostrości przy niektórych rozdzielczościach, a drobne szczegóły bywają słabiej odwzorowane. Model jest też wymagający sprzętowo z powodu 32b enkodera tekstu.