MiniMax H3 Image Highspeed API
MiniMax H3 Image Highspeed is de snelle variant van het open-weights MiniMax H3 Image-model voor tekst-naar-afbeelding en beeldbewerking.
MiniMax H3 Image Highspeed is de snelheidsgeoptimaliseerde variant binnen de MiniMax H3 Image-lijn. Het model accepteert tekst- en beeldinvoer en levert afbeeldingen als uitvoer. Het is een open-weights model dat zowel voor tekst-naar-afbeelding als voor het bewerken van bestaande afbeeldingen kan worden gebruikt. In één generatie kunnen maximaal 16 referentieafbeeldingen worden gecombineerd.
Het model leest lange prompts en kan lange, dichte tekst in afbeeldingen weergeven. De uitvoer heeft een native resolutie van ongeveer 16 megapixel en beeldverhoudingen van 1:3 tot 3:1 zijn mogelijk. De Highspeed-modus is 3 tot 4 keer sneller dan de standaardmodus, die op zijn beurt 1,5 tot 2 keer sneller is dan sommige concurrerende modellen. Het model gebruikt dezelfde parameters en limieten als de standaardversie en kan lokaal op bescheiden hardware draaien.
Het model is geschikt voor tekst-naar-afbeelding-generatie, beeldbewerking, posters, infographics, UI-schermen, marketingmateriaal, rapid prototyping, batchverwerking, complexe composities, consistente personages en scènes met meerdere elementen. Beperkingen zijn onder meer een effectieve ruimtelijke compressieverhouding van 32x, waardoor het bij bepaalde resoluties aanzienlijk waziger kan zijn, en het ontbreken van fijne details. Het model is zwaar door de 32b-tekstencoder.
Bijgewerkt:
MODEL-ID
minimax-h3-image-highspeed- Invoer
- text / image
- Uitvoer
- image
Hoogtepunten
- 3 tot 4 keer sneller dan de standaardmodus
- Tot 16 referentieafbeeldingen per generatie
- Native resolutie van ongeveer 16 megapixel
- Beeldverhoudingen van 1:3 tot 3:1
- Open-weights model
- Draait lokaal op bescheiden hardware
Aanbieders
Vergelijk API-prijzen tussen aanbieders. Kies een aanbieder om alle kosten en voorwaarden te bekijken.
| Beschikbaarheid | |
|---|---|
Historische gegevens zijn geen live statuscontrole. Ontbrekende gegevens betekenen geen storing.
Snelstart
Verstuur een afbeeldingstaak, controleer de status en sla de afbeeldingen op. De voorbeelden gebruiken curl en de standaardbibliotheek van Python 3.
POST https://openapi.felo.ai/api/v1/images/generations
1API-sleutel instellen
Maak een sleutel in je Felo API Platform-account en stel deze in als omgevingsvariabele.
export FELO_API_KEY="YOUR_API_KEY"2Je eerste aanvraag doen
Optionele waarden verschillen per model en zijn hier niet ingesteld. Controleer ze in Playground. Velden staan naast model en prompt, zonder input-omslag.
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"
}'3Taak pollen
De aanvraag retourneert task_id. Controleer elke 3 seconden bij queued of running; stop bij succeeded, failed of interrupted. Maximaal 30 minuten wachten. Bewaar created.json om dezelfde taak verder op te vragen zonder opnieuw te versturen.
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")
PY4Uitvoer downloaden
Sla na succes outputs uit task.json op. HTTPS-URL’s, URL-objecten en b64_json worden ondersteund. Download ondertekende URL’s tijdig; daarvoor is geen API-sleutel nodig.
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
Vervang voor bewerking de voorbeeld-URL door je HTTPS-afbeeldings-URL of een base64-afbeeldings-data-URL. Verstuur één keer en volg dezelfde controle- en opslagstappen.
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"
}
}
]
}'Ondersteunde parameters
- n
- size
- resolution
- aspect_ratio
- output_format
- input_references
Liever de volledige referentie?
API-referentie →Veelgestelde vragen
Wat is MiniMax H3 Image Highspeed?
MiniMax H3 Image Highspeed is de snelheidsgeoptimaliseerde variant binnen de MiniMax H3 Image-lijn. Het model accepteert tekst- en beeldinvoer en levert afbeeldingen als uitvoer. Het is een open-weights model dat zowel voor tekst-naar-afbeelding als voor het bewerken van bestaande afbeeldingen kan worden gebruikt. In één generatie kunnen maximaal 16 referentieafbeeldingen worden gecombineerd. Het model leest lange prompts en kan lange, dichte tekst in afbeeldingen weergeven. De uitvoer heeft een native resolutie van ongeveer 16 megapixel en beeldverhoudingen van 1:3 tot 3:1 zijn mogelijk. De Highspeed-modus is 3 tot 4 keer sneller dan de standaardmodus, die op zijn beurt 1,5 tot 2 keer sneller is dan sommige concurrerende modellen. Het model gebruikt dezelfde parameters en limieten als de standaardversie en kan lokaal op bescheiden hardware draaien. Het model is geschikt voor tekst-naar-afbeelding-generatie, beeldbewerking, posters, infographics, UI-schermen, marketingmateriaal, rapid prototyping, batchverwerking, complexe composities, consistente personages en scènes met meerdere elementen. Beperkingen zijn onder meer een effectieve ruimtelijke compressieverhouding van 32x, waardoor het bij bepaalde resoluties aanzienlijk waziger kan zijn, en het ontbreken van fijne details. Het model is zwaar door de 32b-tekstencoder.
Hoe wordt het gebruik gefactureerd?
Je factuur hangt af van de aanbieder die je gebruikt, de prijzen en je verbruik. Langere invoer of andere voorwaarden kunnen andere prijzen hebben. Gefactureerd op basis van de werkelijke generatiekosten. Zie je factuur voor het uiteindelijke bedrag.
Welke invoer en uitvoer ondersteunt MiniMax H3 Image Highspeed?
Het model accepteert tekst- en beeldinvoer en levert afbeeldingen als uitvoer. Het kan zowel nieuwe afbeeldingen genereren als bestaande afbeeldingen bewerken.
Hoeveel referentieafbeeldingen kan het model combineren?
In één generatie kunnen maximaal 16 referentieafbeeldingen worden gecombineerd.
Welke resoluties en beeldverhoudingen zijn mogelijk?
De uitvoer heeft een native resolutie van ongeveer 16 megapixel. Beeldverhoudingen van 1:3 tot 3:1 worden ondersteund.
Hoe verhoudt de Highspeed-modus zich tot de standaardmodus?
De Highspeed-modus is 3 tot 4 keer sneller dan de standaardmodus. Het model gebruikt dezelfde parameters en limieten als de standaardversie.
Wat zijn de beperkingen van het model?
Door de effectieve ruimtelijke compressieverhouding van 32x kan het model bij bepaalde resoluties aanzienlijk waziger zijn en mist het fijne details. Het model is zwaar door de 32b-tekstencoder.