Introduction
MiniMax H3 Image LoRA Retouche d’image redessine les personnes et les objets de vos images de référence dans une nouvelle scène, une nouvelle tenue, une nouvelle pose ou un nouveau style, avec le modèle à poids ouverts MiniMax H3 et jusqu’à trois de vos propres fichiers LoRA. Envoyez d’une à neuf images, désignez-les comme Picture 1, Picture 2, etc., et récupérez une image en 1k ou 2k, à la forme de la première référence ou dans l’un des quinze ratios d’image.
Choisir un mode selon le matériau de départ
| Matériau de départ | Mode |
|---|---|
| une description écrite | MiniMax H3 Image LoRA Texte vers image |
| une à neuf images à modifier | MiniMax H3 Image LoRA Retouche d’image |
| une image fixe à animer | MiniMax H3 LoRA Image vers vidéo |
Fonctionnalités et points forts
L’identité reprise des références
Les visages, les coiffures et les détails vestimentaires marquants sont conservés pendant que tout le reste change. Lors de notre test, un seul portrait a été placé dans un décor et une pose complètement différents, et le visage comme les cheveux sont restés ceux de la même personne, parfaitement reconnaissable.
Jusqu’à neuf sources numérotées
Combinez dans une même requête une personne, une tenue, un objet et un lieu issus d’images distinctes. La numérotation dans le prompt indique au modèle quelle image joue quel rôle.
Retouche sans censure avec vos propres poids
Les références sont prises telles quelles, quoi qu’elles montrent. Avec un LoRA adapté et notre prompt de contenu le plus fort, l’édition a été rendue telle qu’écrite. Rien n’est examiné ni filtré.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Indiquez ce qu’apporte chaque image, puis décrivez la nouvelle scène, la tenue ou le style. L’identité vient des références : inutile de décrire le visage. 1 caractères minimum · 5000 caractères maximum |
image_urls | Oui | D’une à neuf références, désignées dans le prompt comme <Picture 1>, <Picture 2>, etc. La première image fixe aussi la forme du résultat, sauf si vous choisissez un ratio. 1 éléments minimum · 9 éléments maximum |
aspect_ratio | Non | Laissez-le vide pour suivre la première référence, ou choisissez l’un des quinze ratios. Sans effet sur le prix. |
resolution | Non | Le 1k fait environ un mégapixel, le 2k environ quatre. |
loras | Non | Jusqu’à trois entrées {path, scale} entraînées pour MiniMax H3 ; scale de 0 à 4. Un LoRA de personnage plus la référence donne la tenue d’identité la plus solide. Valeur par défaut: |
output_format | Non | JPEG par défaut, PNG ou WebP si besoin. |
seed | Non | Garde les retouches comparables pendant que vous changez la consigne. |
Tarification
Facturé à l’image, selon la résolution ; chaque image de référence après la première ajoute un petit supplément. Les LoRA n’entraînent aucun supplément.
| Spécification | Prix |
|---|---|
| $0.054 / image |
| $0.126 / image |
Cas d’utilisation
De nouvelles scènes pour la même personne
Un portrait net suffit pour placer quelqu’un sur un balcon, dans une chambre d’hôtel ou sur une scène. Changez la lumière et les vêtements dans le prompt et gardez le visage de l’image.
Changer de tenue ou de produit
Envoyez la personne comme Picture 1 et un vêtement ou un produit comme Picture 2, puis demandez la personne qui le porte ou le tient. Pratique pour les catalogues et pour garder cohérente la tenue d’un personnage.
Changer de style avec un LoRA
Chargez un LoRA anime, pellicule ou VHS et demandez la même image dans ce style. La composition et la personne restent ; le médium change.
Guide de prompt et conseils pratiques
Attribuez les images, puis décrivez le changement
Commencez par une phrase courte par référence, puis décrivez uniquement ce qui doit être différent. Redécrire le visage a tendance à lutter contre la référence plutôt qu’à l’aider.
Moins de références, mais plus claires
Deux ou trois références aux rôles distincts battent en général neuf qui se recoupent, et chaque image après la première alourdit le prix. Recadrez les références pour que la partie qui compte remplisse le cadre.
Des intensités modérées quand l’identité compte
Un LoRA de style puissant à un scale élevé peut tirer les visages vers ses données d’entraînement. Démarrez les LoRA de style entre 0,7 et 1 et ne montez que si le look ne ressort pas.
Démarrage rapide de l’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "minimax/h3-image-lora/edit",
"input": {
"image_urls": [
"https://example.com/reference.png"
],
"output_format": "jpeg",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
La référence API détaille l’authentification, le schéma complet, le polling et la gestion des erreurs.
