API vidéo vers vidéo
Intégrez la restylisation vidéo à votre produit avec l'API vidéo vers vidéo de GoEnhance. Récupérez un ID de modèle à jour, envoyez une vidéo source en HTTPS, choisissez la durée et les contrôles pris en charge, puis récupérez le résultat asynchrone. Cette page décrit l'API propre à GoEnhance et n'implique aucune affiliation avec des marques tierces de styles ou de modèles.
Créer une clé API
Une restylisation vidéo pensée pour les workflows API
Découvrir les styles à l'exécution
Appelez GET /api/v1/video2video/modellist et utilisez la valeur numérique value d'un élément comme model de la requête de génération. La découverte à l'exécution permet à votre application de suivre le catalogue disponible à l'instant T.
Maîtriser la transformation
Envoyez une vidéo source ainsi qu'un modèle et une durée. Selon le modèle retenu, des contrôles facultatifs permettent d'ajuster le poids du prompt, l'influence de la vidéo source, la conservation du sujet, le traitement de l'arrière-plan, la seed, la résolution et l'envoi du callback.
Vérifiez les contrôles propres au modèle avant d'envoyer chaque requête de transformation.
Fonctionnalités de l'API vidéo vers vidéo
Vidéo source
Fournissez <code>reference_video_url</code> sous forme de fichier MP4 ou MOV public en HTTPS. La documentation actuelle indique une taille de fichier maximale de 50 Mo.
Modèle et durée
Envoyez la valeur numérique <code>model</code> renvoyée par l'endpoint de liste des styles ainsi qu'une durée obligatoire. La plage documentée va de 3 à 30 secondes.
Prompt et influence
Pour les styles V2 pris en charge, utilisez un prompt facultatif et <code>video_refer</code> pour déplacer l'accent vers le prompt, vers un équilibre ou vers la vidéo source.
Conservation du sujet
Les requêtes compatibles peuvent conserver une personne détectée ou un sujet personnalisé, isoler le sujet principal ou le placer sur un fond uni spécifié.
Résolution
Les résolutions documentées pour V5 sont <code>540p</code> et <code>720p</code>, 720p étant indiquée comme valeur par défaut.
Livraison asynchrone
Conservez l'<code>img_uuid</code> renvoyé, puis interrogez l'endpoint de détail de tâche ou fournissez une URL de callback publique en HTTPS pour recevoir les changements d'état.
Fiez-vous aux tarifs réels de votre compte plutôt qu'à un prix unique sans fondement.
Repères tarifaires de l'API vidéo vers vidéo
Pas de tarif forfaitaire unique publié
La documentation publique actuelle de l'endpoint vidéo vers vidéo ne publie pas de prix fixe s'appliquant à tous les styles et à toutes les requêtes.
Vérifier les tarifs actuels de l'API GoEnhance
Confirmez la consommation de jetons actuelle du modèle utilisé dans votre compte GoEnhance ou sur la page tarifaire en vigueur avant d'estimer un budget de production.
Budgétiser à partir d'une requête valide
N'estimez les coûts qu'après avoir choisi le modèle disponible ainsi que la durée, la résolution et les contrôles de transformation pris en charge ; ne partez pas du principe que tous les styles suivent la même règle de facturation.
Intégrer l'API GoEnhance en trois étapes
1
1. Découvrir et valider
Créez une clé API côté serveur, appelez l'endpoint de liste des styles, sélectionnez un ID de modèle numérique à jour, puis validez l'URL de la vidéo source, son format, sa taille et la durée demandée.
2
2. Envoyer la transformation
Envoyez un POST vers
https://api.goenhance.ai/api/v1/video2video/generate avec une authentification bearer et les champs obligatoires model, duration et reference_video_url. N'ajoutez que les contrôles pris en charge par le modèle retenu. 3
3. Finaliser la tâche asynchrone
Vérifiez à la fois la réponse HTTP et les champs
code/msg du JSON, conservez data.img_uuid, puis interrogez GET /api/v1/jobs/detail ou traitez des événements de callback idempotents jusqu'à la réussite ou l'échec.Utilisez la restylisation pilotée par modèle là où une orchestration serveur reproductible compte.
Cas d'usage de l'API vidéo vers vidéo
Styles animation et illustration
Restylisez des rushes autorisés en rendu animé, illustré, encre, pâte à modeler, pixel ou tout autre traitement visuel actuellement disponible.
Déclinaisons de campagne
Créez plusieurs directions visuelles à partir d'une même source animée et acheminez chaque résultat vers un workflow de validation.
Visuels musicaux et scéniques
Appliquez un traitement homogène à de courts extraits de performance tout en conservant leur mouvement et leur rythme.
Concepts d'animation produit
Explorez des études de mouvement stylisées à partir de rushes produit existants avant d'arrêter une direction de production définitive.
Restylisation des personnages et des sujets
Utilisez les contrôles de sujet pris en charge lorsque le workflow doit traiter la personne principale ou un sujet personnalisé différemment de l'arrière-plan.
Pipelines créatifs automatisés
Reliez les envois, la validation, le suivi des tâches, les callbacks, la modération, le stockage et la diffusion dans un workflow backend traçable.
Réponses sur les endpoints, les fichiers sources, les tarifs, les contrôles et la fin de tâche asynchrone.