img_uuid renvoyé, puis interrogez le résultat ou recevez des rappels HTTPS.API HappyHorse 1.1 pour la génération de vidéo
Accédez à l'API HappyHorse 1.1 via l'API ouverte indépendante de GoEnhance pour la conversion de texte en vidéo, d'image en vidéo (première image) ou via un flux de travail avec image de référence. Soumettez une tâche asynchrone, enregistrez le
Créer une clé API
Choisir le bon mode d'API HappyHorse
Texte-vers-vidéo
Envoyez model: happyhorse-1-1 avec un prompt requis et sans image_url. Sélectionnez un ratio, une durée et une résolution documentés pour la vidéo générée.
Image-vers-vidéo (première image)
Ajoutez image_url pour animer une première image. L'image doit être au format JPEG, PNG ou WEBP, mesurer au moins 300px, peser moins de 10 Mo et respecter la plage de ratio documentée de 1:2,5 à 2,5:1.
Vidéo avec image de référence
Utilisez model: happyhorse-1-1-ref avec 1 à 9 URL dans image_urls. Référez-vous à chaque source dans le prompt sous la forme [Image 1], [Image 2], et ainsi de suite.
Validez le mode de requête sélectionné avant d'envoyer du travail vers votre file d'attente de production.
Capacités et limites de l'API HappyHorse 1.1
Deux modes d'entrée standard
Utilisez un prompt seul pour la conversion texte-vers-vidéo ou ajoutez une <code>image_url</code> pour la conversion image-vers-vidéo (première image).
Modèle multi-référence séparé
Utilisez <code>happyhorse-1-1-ref</code> avec 1 à 9 URL d'images de référence requises ; il ne prend pas en charge la conversion pure texte-vers-vidéo.
Durée de 3 à 15 secondes
Définissez <code>duration</code> sur un entier compris entre 3 et 15 secondes. La valeur par défaut documentée est de 5 secondes.
Sortie 720p ou 1080p
Choisissez <code>720p</code> ou <code>1080p</code>. La valeur par défaut documentée est <code>720p</code>.
Ratios portrait, carré et paysage
La méthode standard prend en charge les formats 16:9, 9:16, 1:1, 4:3 et 3:4. Le mode référence liste également les formats 4:5 et 5:4.
Interrogation et rappels
Conservez le <code>img_uuid</code>, interrogez le point de terminaison des détails de la tâche ou fournissez une URL de rappel HTTPS publique pour les mises à jour de statut.
GoEnhance documente une tarification par seconde de $0.02 par jeton et qualifie actuellement ces tarifs d'offre à durée limitée.
Tarification de l'API HappyHorse 1.1
720p : $0.104 par seconde
La génération 720p utilise 5,2 jetons par seconde. Une requête de 5 secondes utilise 26 jetons, soit $0.52 selon la conversion documentée.
1080p : $0.144 par seconde
La génération en 1080p utilise 7,2 jetons par seconde, soit $0.144 par seconde générée.
Estimation par durée
Multipliez le tarif par seconde sélectionné par la durée demandée de 3 à 15 secondes. Consultez la référence de l'API en direct avant les lots de production, car les tarifs promotionnels peuvent changer.
Intégrer l'API HappyHorse 1.1
1
1. Créer et protéger une clé API
Créez une clé GoEnhance et envoyez-la en tant qu'autorisation bearer depuis un code côté serveur sécurisé.
2
2. Sélectionner le modèle
Choisissez
happyhorse-1-1 pour une génération à partir d'un prompt uniquement ou d'une première image, ou happyhorse-1-1-ref pour 1 à 9 images de référence. 3
3. Construire et valider la charge utile
Fournissez le prompt requis, puis validez les champs d'image, la durée, la résolution, le ratio et l'URL de rappel pour le mode choisi.
4
4. Soumettre la tâche vidéo
Effectuez une requête POST vers
https://api.goenhance.ai/api/v1/videos/generations et stockez l'img_uuid renvoyé. 5
5. Suivre le statut
Interrogez
GET https://api.goenhance.ai/api/v1/jobs/detail?img_uuid=... ou recevez les changements de statut via un rappel HTTPS public. 6
6. Gérer le résultat final
Traitez les succès et les échecs de manière idempotente, vérifiez l'actif renvoyé et évitez les travaux en aval en double lorsque le polling et les rappels se chevauchent.
Connectez les requêtes de génération structurées aux flux de révision, de stockage et de livraison.
Cas d'utilisation développeur pour l'API HappyHorse
Variantes de vidéos de campagne
Générez des concepts de mouvement courts à partir de prompts structurés pour la révision créative et le montage en aval.
Mouvement de produit et de marque
Animez une première image approuvée pendant que votre backend contrôle la durée, la résolution et la gestion de la finalisation.
Études d'interaction entre personnages
Utilisez le modèle de référence pour décrire comment les sujets issus d'images sources approuvées doivent apparaître ensemble dans une même scène.
Prévisualisation de storyboard
Transformez des descriptions de plans en clips révisables avant de vous engager dans un flux de production plus large.
Pipelines créatifs localisés
Paramétrez les prompts pour des variantes régionales tout en conservant une soumission et un suivi des tâches cohérents.
Files d'attente d'actifs automatisées
Connectez la génération, la persistance de l'état des tâches, les rappels, le stockage et l'approbation humaine dans un service backend.
Réponses concernant la tarification, les modes de requête, les limites d'entrée et la gestion des tâches asynchrones.