img_uuid renvoyé, puis récupérez le résultat par polling ou callback HTTPS.API d'effets vidéo IA pour des workflows créatifs automatisés
Accédez aux effets vidéo IA via l'API indépendante de GoEnhance. Listez les modèles d'effets disponibles, envoyez une image de référence dont vous détenez les droits avec un identifiant d'effet, conservez l'
Créer une clé API
Capacités de l'API d'effets vidéo IA
Découvrir les effets disponibles
Appelez GET /api/v1/videoeffect/list avec une authentification Bearer pour récupérer les identifiants d'effets, les libellés et les URL d'aperçu à jour, plutôt que de figer un catalogue obsolète dans votre code.
Générer et suivre une tâche
Envoyez en POST un reference_img accessible publiquement et un effect_id valide vers /api/v1/videoeffect/generate, puis conservez l'img_uuid renvoyé pour le suivi du statut.
Vérifiez les identifiants d'accès, l'accessibilité des médias, l'identité du modèle et la configuration du callback avant de créer une tâche.
Éléments essentiels d'une requête à l'API d'effets vidéo IA
Authentification Bearer
Transmettez votre clé d'API GoEnhance dans l'en-tête <code>Authorization</code> et conservez-la côté serveur, jamais dans du code client.
Découverte des modèles
Utilisez <code>GET /api/v1/videoeffect/list</code> pour récupérer le catalogue en cours avant d'afficher les choix d'effets dans votre produit.
Image de référence
Fournissez dans <code>reference_img</code> une URL d'image HTTPS accessible publiquement et n'utilisez que des contenus dont vous êtes propriétaire ou dont le traitement vous est autorisé.
Identifiant d'effet
Transmettez l'<code>effect_id</code> exact du modèle choisi et validez-le à partir de la réponse de la liste en cours, plutôt que de deviner les identifiants.
Callback facultatif
Renseignez <code>custom_callback_url</code> si vous souhaitez recevoir les notifications de statut sur un endpoint HTTPS public.
Identifiant de tâche asynchrone
Conservez le <code>data.img_uuid</code> issu d'une réponse d'envoi réussie et associez-le à votre enregistrement de requête interne.
Appuyez-vous sur les données de modèles à jour et sur la documentation, et non sur un tarif universel inventé ou périmé.
Tarifs de l'API d'effets vidéo IA
Un tarif variable selon l'effet
Le tarif de l'API d'effets vidéo IA dépend du modèle choisi et du catalogue GoEnhance en vigueur. Ne partez pas du principe qu'un tarif unique s'applique à tous les effets.
Consulter le catalogue à jour
Prenez l'API de liste des modèles et la documentation GoEnhance en vigueur comme référence pour l'effet que vous prévoyez d'exécuter.
Chiffrer avant l'envoi
Déterminez l'<code>effect_id</code> retenu et ses conditions de facturation actuelles avant de mettre des lots de production en file d'attente, car les conditions du catalogue peuvent évoluer.
Intégrer les effets vidéo IA en trois étapes
1
1. Découvrir et valider
Récupérez la liste des effets, choisissez un
effect_id exact et vérifiez que votre image de référence HTTPS est accessible et que son traitement est autorisé. 2
2. Envoyer et conserver
Envoyez en POST
reference_img, effect_id et une URL de callback facultative, puis enregistrez le data.img_uuid de la réponse. 3
3. Récupérer le résultat final
Interrogez
GET /api/v1/jobs/detail?img_uuid=... en polling ou traitez les corps de callback de façon idempotente jusqu'à ce que la tâche atteigne success ou failed.Construisez des workflows d'effets reproductibles autour de contenus qui vous appartiennent ou que vous êtes autorisé à transformer.
Cas d'usage de l'API d'effets vidéo IA
Outils pour créateurs
Laissez vos utilisateurs choisir des effets validés et transformer, depuis votre application, des images fixes autorisées en courtes séquences animées.
Déclinaisons de campagne
Mettez en file d'attente des variantes d'effets pour vos concepts marketing tout en gardant dans votre propre workflow la titularité des sources, la modération et la validation.
Chaînes de contenus utilisateurs
Reliez les envois de fichiers, le choix de l'effet, le traitement asynchrone et la livraison des résultats dans une chaîne backend traçable.
Expériences de divertissement
Concevez des fonctionnalités ludiques et des animations thématiques activées volontairement, avec un consentement explicite et des contrôles de conformité éditoriale.
Production créative par lots
Conservez les identifiants de tâches et traitez les résultats finaux de manière indépendante afin que les lots puissent reprendre après un dépassement de délai, sans doublon d'envoi.
Automatisation des médias
N'acheminez les vidéos terminées vers vos systèmes de stockage, de relecture, de modération et de publication qu'après validation de la réponse finale.
Réponses sur les endpoints, les tarifs, les entrées, la livraison asynchrone et les protections en production.