Introduction
MiniMax H3 Singularity LoRA Références vers vidéo construit un plan à partir de vos références sur Singularity, le fine-tune communautaire du modèle à poids ouverts MiniMax H3 entraîné en HDR, avec jusqu’à trois de vos propres LoRA H3 chargés. Envoyez jusqu’à neuf images, trois clips et trois extraits audio, désignez-les par leur numéro dans le prompt, et récupérez de 3 à 15 secondes en 480p à 1080p avec une bande son stéréo, 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 image de départ | MiniMax H3 Singularity LoRA Image vers vidéo |
| des images, clips ou sons de référence | MiniMax H3 Singularity LoRA Références vers vidéo |
| seulement une scène écrite | MiniMax H3 LoRA Texte vers vidéo |
Fonctionnalités et points forts
La chorégraphie depuis un clip, l’identité depuis des images
Un clip de référence transmet le mouvement et la caméra, et les images fixes figent le visage et le costume. L’entraînement de Singularity sur de l’action rapide à grande plage dynamique garde ce mouvement emprunté net au lieu de le faire baver.
Des LoRA H3 standard sur une base plus nette
Tout LoRA entraîné pour MiniMax H3 se charge ici sans modification. Associez un LoRA de personnage à des images de la même personne pour la tenue d’identité la plus ferme.
Références et résultat sans censure
Les références sont prises telles quelles, quoi qu’elles montrent. Avec un LoRA adapté et notre prompt de contenu 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 | Attribuez d’abord un rôle à chaque entrée (<Picture 1> est le combattant, <Video 1> le mouvement), puis écrivez l’action en plusieurs temps et terminez par le son. 1 caractères minimum · 7000 caractères maximum |
reference_image_urls | Non | Jusqu’à neuf images ; chacune ajoute un supplément par référence. Servez-vous-en pour le visage, la tenue et le lieu. 1 éléments minimum · 9 éléments maximum |
reference_video_urls | Non | Jusqu’à trois clips pour la chorégraphie ou la caméra. Facturés comme des secondes produites, dans la limite de 15 au total ; leur son est repris automatiquement. 1 éléments minimum · 3 éléments maximum |
reference_audio_urls | Non | Jusqu’à trois extraits audio pour un rythme, une voix ou des impacts. 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’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 les prises comparables pendant que vous changez de références. |
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
Reprendre une chorégraphie avec un nouvel interprète
Envoyez la chorégraphie comme Video 1 et le nouvel interprète comme Picture 1, puis décrivez le décor. Le mouvement est repris ; la personne et le lieu sont les vôtres.
Des combattants cohérents sur toute une séquence
Gardez fixes les images et le LoRA de chaque combattant et ne changez que le temps que vous décrivez. En plan large, les visages tiennent mieux sur ce fine-tune que sur le modèle classique.
Des plans calés sur la musique
Ajoutez le morceau comme Audio 1 et demandez un mouvement sur le rythme. Avec un clip de référence de la danse, le résultat suit à la fois le tempo et la chorégraphie.
Guide de prompt et conseils pratiques
Des clips de référence courts et propres
Un clip de deux à quatre secondes montrant exactement le mouvement voulu fonctionne mieux qu’une longue prise, et coûte moins cher : les secondes de clip sont facturées comme des secondes produites, jusqu’à 15 au total. Coupez l’élan et la réception dont vous n’avez pas besoin, et préférez une caméra fixe dans la référence pour que le modèle lise le mouvement du corps et non celui du cadreur.
Un seul rôle par image
Une image pour le visage, une pour la tenue, une pour la pièce. Des images du même sujet sous des angles proches ajoutent du coût sans ajouter de contrôle. Écrivez ensuite le prompt en plusieurs temps : Picture 1 entre, reprend la pirouette de Video 1, atterrit face à la caméra, avec le coup de batterie d’Audio 1 sur la réception.
Prévoyez le temps de rendu
Singularity rend plus lentement que la famille MiniMax H3 LoRA classique ; notre plan de référence de cinq secondes en 480p a pris environ 80 secondes. Calez la chorégraphie en 480p avant de passer au 1080p.
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-singularity-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.
