Introduction
HappyHorse 1.1 Image vers vidéo anime une image d’ouverture fournie dans image_url. Le prompt est obligatoire et décrit le mouvement qui suit ; le clip dure de 3 à 15 secondes entières en 720p ou 1080p, avec une bande-son générée. Il n’y a ni champ de format d’image ni champ d’image de fin : l’image fixe la forme, et la fin correspond à l’aboutissement du mouvement demandé.
Choisir le mode selon le matériau de départ
| Matériau de départ | Mode |
|---|---|
| une scène écrite ou un script | HappyHorse 1.1 Texte vers vidéo |
| une image d’ouverture validée | HappyHorse 1.1 Image vers vidéo |
| une à neuf images de référence | HappyHorse 1.1 Références vers vidéo |
Fonctionnalités et points forts
L’image fixe le sujet et la forme
L’image d’ouverture est suivie de près, ce qui fait de ce point de terminaison le chemin fiable vers un résultat littéral, images sources sans censure comprises. Dans l’exemple tailgate-turn, la tenue, le pick-up et le contre-jour viennent tous de l’image, et le prompt lui demande seulement de baisser la bouteille, de balancer une fois ses bottes et de tourner la tête vers le soleil bas.
Pas d’image de fin à viser
Ce point de terminaison ne prend que image_url : un plan ne peut donc pas être calé sur une composition finale. Les mouvements qui se résolvent d’eux-mêmes fonctionnent le mieux. L’exemple quiet-hold, ce sont quatre secondes de quasi-immobilité : une expiration, une épaule qui s’abaisse et un transfert de poids contre le cadre de la fenêtre, presque sans mouvement de caméra.
Limites d’entrée et de sortie
L’image d’ouverture doit mesurer au moins 300 px de côté, avoir un rapport entre 1:2,5 et 2,5:1 et peser au plus 20 Mo. La sortie dure de 3 à 15 secondes, 5 par défaut, en 720p (par défaut) ou 1080p, et la bande-son est toujours générée avec l’image.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Obligatoire. Décrivez ce qui change après l’image — action, caméra, rythme — et non l’image elle-même. 1 caractères minimum · 2500 caractères maximum |
image_url | Oui | L’image d’ouverture. Elle fixe le sujet et la composition, et définit la forme de sortie. |
resolution | Non | 720p ou 1080p. |
duration_seconds | Non | Secondes entières, de 3 à 15. Il n’y a pas d’image de clôture : gardez donc un mouvement qui se résout dans ce temps. |
seed | Non | Entier de 0 à 2147483647 pour le départ aléatoire ; sans lui, chaque exécution tire le sien. |
Tarification
| Spécification | Prix |
|---|---|
| $0.14 / seconde |
| $0.18 / seconde |
Cas d’utilisation
Animer une image sans censure ou très dirigée
Ce chemin suit l’image qu’il reçoit : le travail sans censure commence donc ici plutôt que dans text-to-video, qui rejette les prompts dépassant sa limite de contenu. Fournissez l’image que vous avez conçue et n’écrivez que le mouvement ; le sujet apparaît tel qu’il a été dessiné ou photographié au lieu d’être réinterprété à partir d’une phrase.
Du mouvement d’environnement autour d’une pose tenue
L’exemple wasteland-hood-two garde deux silhouettes sur le capot d’une voiture en panne et n’écrit que ce qui existe en mouvement : un tissu déchiré que le vent soulève et laisse retomber, une brume de chaleur qui ondule, des tourbillons de poussière qui traversent la route et un lent travelling avant. Il a été généré en 1080p avec la durée par défaut.
Inserts courts et plans de coupe
Un clip de trois ou quatre secondes avec un mouvement de caméra minimal convient aux inserts entre des plans plus longs. Limitez l’action à une respiration ou à un geste, comme quiet-hold, pour que le mouvement se termine dans la durée au lieu d’être coupé en route.
Guide de prompt et conseils pratiques
Ne donner au prompt que du mouvement
Le prompt est obligatoire : servez-vous-en pour ce qui change, c’est-à-dire l’action, la caméra et le rythme. Le prompt de wasteland-hood-two ne décrit jamais la composition ; il décrit le vent, la brume de chaleur et la poussière. Redécrire l’image consomme la limite de 2 500 caractères pour ce que l’image fixe déjà.
Dimensionner le mouvement selon la durée
Sans image de fin, un mouvement qui ne peut pas s’achever dans le temps choisi s’arrête simplement là où le clip se termine. Accordez l’action à la durée : un geste pour un clip court, une courte suite comme baisser, balancer, tourner pour un clip plus long, comme tailgate-turn sur six secondes.
Recadrer avant l’envoi
L’image fixe la forme de la sortie : recadrez-la d’abord au format de livraison et vérifiez les limites de taille. Esquissez en 720p, puis relancez en 1080p pour la livraison. Chaque passe produit sa propre prise, alors gardez le texte fixe pendant la comparaison.
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": "alibaba/happyhorse-1.1/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p"
}
}'
# 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.
