Felo API PlatformFelo API Platform
Retour aux modèles

MiniMax H3 Image Highspeed API

MiniMax H3 Image Highspeed est la variante rapide du modèle open-weights MiniMax H3 Image, générant et éditant des images à partir de texte et d'images de référence.

MiniMax H3 Image Highspeed est une déclinaison optimisée pour la vitesse du modèle d'image MiniMax H3 Image. Elle accepte des entrées texte et image et produit des images, avec la possibilité de combiner jusqu'à 16 images de référence en une seule génération. Le mode Highspeed est annoncé comme 3 à 4 fois plus rapide que le mode standard, tout en conservant les mêmes paramètres et limites que ce dernier.

Le modèle produit des images à des résolutions natives d'environ 16 mégapixels et prend en charge des ratios d'aspect allant de 1:3 à 3:1. Il sait rendre du texte long et dense, lire des invites longues et fonctionner localement sur du matériel modeste. Ses points forts incluent la création de scènes multi-éléments, la cohérence des personnages et le prototypage rapide.

Il convient particulièrement aux tâches de génération texte-image, d'édition d'images, de création d'affiches, d'infographies, d'écrans d'interface, de supports marketing et de traitement par lots. Ses limites incluent un ratio de compression spatiale effective de 32x pouvant rendre certaines résolutions nettement plus floues, un manque de détail fin et un poids important dû à l'encodeur de texte de 32b.

Mis à jour:

ID DU MODÈLE

minimax-h3-image-highspeed
Entrée
text / image
Sortie
image

Points clés

  • Mode 3 à 4 fois plus rapide
  • Jusqu'à 16 images de référence
  • Résolutions natives d'environ 16 mégapixels
  • Ratios d'aspect de 1:3 à 3:1
  • Modèle open-weights
  • Exécution locale possible

Fournisseurs

1 fournisseurs

Comparez les prix des API entre fournisseurs. Sélectionnez un fournisseur pour voir tous les tarifs et conditions.

Fournisseur · Détails des tarifs
Disponibilité

Démarrage rapide

Envoyez une tâche image, consultez son état, puis enregistrez les images. Les exemples utilisent curl et la bibliothèque standard de Python 3.

POST https://openapi.felo.ai/api/v1/images/generations

1Configurer votre clé API

Créez une clé depuis votre compte Felo API Platform et définissez-la comme variable d'environnement.

export FELO_API_KEY="YOUR_API_KEY"

2Effectuer votre première requête

Les valeurs facultatives dépendent du modèle et ne sont pas prédéfinies ici. Vérifiez-les dans Playground. Les champs sont au même niveau que model et prompt, sans enveloppe 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"
}'

3Interroger la tâche

La soumission renvoie task_id. Interrogez toutes les 3 secondes pendant queued ou running ; arrêtez à succeeded, failed ou interrupted. Attente maximale : 30 minutes. Gardez created.json pour reprendre sans soumettre une nouvelle tâche.

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")
PY

4Télécharger la sortie

Après réussite, enregistrez outputs depuis task.json : URL HTTPS, objets URL ou b64_json. Téléchargez rapidement les URL signées. Le téléchargement des images ne nécessite pas de clé 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)
PY
input_references

Pour modifier une image, remplacez l’URL par votre URL HTTPS ou une data URL d’image en base64. Soumettez une fois, puis suivez les mêmes étapes de consultation et d’enregistrement.

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"
      }
    }
  ]
}'

Paramètres pris en charge

  • n
  • size
  • resolution
  • aspect_ratio
  • output_format
  • input_references

Besoin de la référence complète ?

Référence API →

Questions fréquentes

Qu'est-ce que MiniMax H3 Image Highspeed?

MiniMax H3 Image Highspeed est une déclinaison optimisée pour la vitesse du modèle d'image MiniMax H3 Image. Elle accepte des entrées texte et image et produit des images, avec la possibilité de combiner jusqu'à 16 images de référence en une seule génération. Le mode Highspeed est annoncé comme 3 à 4 fois plus rapide que le mode standard, tout en conservant les mêmes paramètres et limites que ce dernier. Le modèle produit des images à des résolutions natives d'environ 16 mégapixels et prend en charge des ratios d'aspect allant de 1:3 à 3:1. Il sait rendre du texte long et dense, lire des invites longues et fonctionner localement sur du matériel modeste. Ses points forts incluent la création de scènes multi-éléments, la cohérence des personnages et le prototypage rapide. Il convient particulièrement aux tâches de génération texte-image, d'édition d'images, de création d'affiches, d'infographies, d'écrans d'interface, de supports marketing et de traitement par lots. Ses limites incluent un ratio de compression spatiale effective de 32x pouvant rendre certaines résolutions nettement plus floues, un manque de détail fin et un poids important dû à l'encodeur de texte de 32b.

Comment l'usage est-il facturé ?

Votre facture dépend du fournisseur utilisé, de ses tarifs et de votre usage. Des entrées plus longues ou d'autres conditions peuvent avoir des tarifs différents. Facturé selon le coût réel de génération. Consultez votre facture pour le montant final.

Quels types d'entrées le modèle accepte-t-il ?

Le modèle accepte du texte et des images en entrée, et produit des images en sortie.

Combien d'images de référence peut-il combiner ?

Il peut combiner jusqu'à 16 images de référence en une seule génération.

Quelle est la différence avec le mode standard de MiniMax H3 Image ?

Le mode Highspeed est 3 à 4 fois plus rapide que le mode standard, avec des paramètres et limites identiques.

Quelles résolutions et quels ratios d'aspect sont pris en charge ?

Le modèle génère des images à des résolutions natives d'environ 16 mégapixels et prend en charge des ratios d'aspect de 1:3 à 3:1.

Peut-il fonctionner sur du matériel modeste ?

Oui, il peut s'exécuter localement sur du matériel modeste. Un utilisateur rapporte avoir généré des images de 5 à 10 mégapixels avec 16 Go de VRAM.

Modèles liés