Introduction
MiniMax H3 LoRA Références vers vidéo construit un plan à partir de vos références et de jusqu’à trois de vos propres fichiers LoRA sur le modèle à poids ouverts MiniMax H3. Envoyez jusqu’à neuf images, trois clips et trois extraits audio, désignez-les par leur numéro dans le prompt, et récupérez un MP4 de 3 à 15 secondes avec bande son stéréo en 480p, 540p, 768p ou 1080p, dans l’un des sept ratios d’image.
Choisir un mode selon le matériau de départ
| Matériau de départ | Mode |
|---|---|
| une scène écrite | MiniMax H3 LoRA Texte vers vidéo |
| une image de départ | MiniMax H3 LoRA Image vers vidéo |
| des images, clips ou sons de référence | MiniMax H3 LoRA Références vers vidéo |
Fonctionnalités et points forts
Trois types de références dans une même requête
Les images fixent un visage, une tenue ou une pièce. Les clips apportent le mouvement, le rythme et la caméra, et leur bande son suit automatiquement. Les extraits audio donnent une voix, un rythme ou une ambiance à suivre. Désignez-les comme Picture 1, Video 1 et Audio 1 pour que chaque entrée ait un rôle clair.
LoRA et références ensemble
Un LoRA de personnage et des images de référence de la même personne tiennent l’identité mieux que l’un ou l’autre seul. Ajoutez un LoRA de style à un scale plus bas, et tout le plan prend votre look sans perdre le sujet.
Sans censure sur toutes les entrées
Les images de référence sont acceptées telles quelles, quoi qu’elles montrent. Avec un LoRA conçu pour le contenu le plus fort et notre prompt le plus fort, le plan a été rendu tel qu’écrit avec le sujet de référence, et la bande sonore est revenue dans le même fichier.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Nommez chaque entrée par son numéro et donnez-lui un seul rôle : <Picture 1> est la femme, <Picture 2> la pièce, <Video 1> le mouvement de caméra, Audio 1 sa voix. 1 caractères minimum · 7000 caractères maximum |
reference_image_urls | Non | Jusqu’à neuf images. Chacune ajoute un supplément par référence. 1 éléments minimum · 9 éléments maximum |
reference_video_urls | Non | Jusqu’à trois clips pour le mouvement, le rythme ou la caméra. Leurs secondes sont facturées comme des secondes produites, dans la limite de 15 au total. 1 éléments minimum · 3 éléments maximum |
reference_audio_urls | Non | Jusqu’à trois extraits audio pour une voix, un rythme ou une ambiance. Chacun ajoute un supplément par référence. 1 éléments minimum · 3 éléments maximum |
aspect_ratio | Non | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 ou 9:21. Sans effet sur le prix. |
resolution | Non | 480p, 540p, 768p ou 1080p. Le tarif à la seconde augmente à chaque palier. |
duration_seconds | Non | Durée produite de 3 à 15 secondes. Les secondes des clips de référence s’y ajoutent à la facturation. |
loras | Non | Jusqu’à trois entrées {path, scale} entraînées pour MiniMax H3 ; scale de 0 à 4. Valeur par défaut: |
seed | Non | Garde une série comparable pendant que vous changez de références ou d’intensités. |
Tarification
Facturé à la seconde selon la résolution choisie ; les secondes des clips de référence comptent comme secondes facturées (jusqu’à 15 au total), et chaque image ou extrait audio de référence ajoute un supplément par référence. Les LoRA n’entraînent aucun supplément.
| Spécification | Prix |
|---|---|
| $0.06 / seconde |
| $0.09 / seconde |
| $0.12 / seconde |
| $0.24 / seconde |
Cas d’utilisation
Un personnage récurrent dans de nouvelles scènes
Gardez les deux ou trois mêmes images de votre personnage, ajoutez son LoRA, et ne changez d’un plan à l’autre que les lignes de décor et d’action. Chaque nouvelle scène repart de la même identité au lieu de la retirer au sort.
Reprendre un mouvement d’un clip
Envoyez un court clip de la danse, du geste de combat ou du mouvement de caméra voulu, plus une image fixe du nouvel interprète, et décrivez le nouveau décor. Précisez noir sur blanc que la personne vient de l’image et le mouvement seulement du clip : lors de notre test, sans cette phrase, la danseuse du clip est arrivée avec le mouvement. Gardez le clip court, car ses secondes sont facturées comme des secondes produites.
Poser une voix sous l’image
Ajoutez un extrait de voix ou de musique comme Audio 1 et dites au modèle qui parle ou sur quoi la scène bouge. C’est le moyen le plus rapide d’obtenir une réplique dans une voix que vous avez déjà.
Guide de prompt et conseils pratiques
Commencez par la carte des entrées
Ouvrez le prompt par une phrase courte par entrée : Picture 1 est la femme, Picture 2 la chambre d’hôtel, Video 1 le travelling. Écrivez ensuite l’action et terminez par le son. Les entrées sans rôle ont tendance à se mélanger.
Surveillez le budget des références
Chaque image et chaque extrait audio de référence ajoute un petit supplément, et les secondes de clip sont facturées comme des secondes produites, jusqu’à 15 au total. L’estimation en direct affiche le montant complet avant l’envoi. Neuf images qui se recoupent coûtent plus cher et tiennent en général moins bien l’identité que trois bonnes.
Laissez le LoRA porter le look
Quand un LoRA de style est chargé, ne décrivez pas aussi ce style en détail dans le prompt. Décrivez le sujet et l’action, et laissez les poids s’occuper du rendu.
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-lora/reference-to-video",
"input": {
"aspect_ratio": "16:9",
"duration_seconds": 5,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "480p",
"reference_image_urls": [
"https://example.com/reference.png"
]
}
}'
# 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.
