Si vous n’avez rien à intégrer et voulez simplement des vidéos, vous pouvez vous passer de l’ingénierie : notre studio encapsule le même modèle avec validation des fichiers, enregistrement dans le navigateur, stockage et téléchargements.
Le contenu d’une requête à l’API OmniHuman 2
Une requête comporte deux champs obligatoires et un champ facultatif. L’URL de l’image pointe vers la personne (ou les personnes) à animer ; l’URL de l’audio pointe vers la voix ou la chanson qui pilote la performance ; le prompt facultatif décrit le mouvement, l’ambiance, les détails de la scène et les mouvements de caméra. Les résultats sont généralement livrés de façon asynchrone via une file d’attente : vous soumettez, recevez un identifiant de requête, puis interrogez le statut ou recevez un webhook quand la vidéo est prête.
- image_url — obligatoire ; l’image fixe à animer.
- audio_url — obligatoire ; un MP3 ou WAV qui définit la durée et la synchronisation labiale.
- prompt — facultatif ; pris en charge en anglais, chinois, japonais, coréen, espagnol (Mexique) et indonésien.
Les limites d’entrée à valider en amont
Les requêtes rejetées font perdre du temps et parfois de l’argent : validez donc de votre côté avant d’appeler le modèle. L’image doit être dans un format courant comme JPEG, PNG, WEBP, BMP, TIFF, GIF ou HEIC, ne pas dépasser 30 Mo, mesurer de 300 à 6 000 pixels de côté, avec un rapport largeur/hauteur de 0,4 à 2,5. L’audio doit être en WAV ou MP3, 15 Mo maximum, et durer de 4 à 300 secondes.
Les enregistrements faits dans le navigateur sont généralement en WebM ou Opus, que le modèle n’accepte pas. Convertissez-les en WAV ou MP3 avant l’envoi — notre studio réencode les enregistrements en WAV mono 22,05 kHz, ce qui garde un clip de cinq minutes sous la limite de taille.
Sortie et facturation
Une tâche terminée renvoie l’URL du fichier vidéo et la durée facturée, qui correspond à la longueur de l’audio fourni. La sortie est un MP4 en 720p native. Les URL des fournisseurs peuvent expirer : en production, copiez le fichier dans votre propre stockage dès la fin de la tâche au lieu de pointer directement vers le fournisseur.
Comme le coût dépend du nombre de secondes générées, mesurez la durée de l’audio côté serveur — ne vous fiez jamais à une durée envoyée par le navigateur — et réservez le coût avant de soumettre, pour que des tâches simultanées ne puissent pas dépasser un solde.
Un flux prêt pour la production
Le schéma que nous appliquons à chaque rendu sur ce site :
- 1Import vers un stockage privéÉmettez des URL d’import signées à courte durée de vie ; n’exposez jamais de liens publics permanents vers les photos des utilisateurs.
- 2Vérification côté serveurRemesurez la durée de l’audio et confirmez l’existence des deux fichiers avant tout débit.
- 3Réserver, puis soumettreRéservez les crédits de façon atomique, soumettez la tâche et remboursez automatiquement si la soumission échoue.
- 4Finalisation idempotenteAu webhook ou à l’interrogation, récupérez le résultat, stockez le MP4 et marquez la tâche comme terminée une seule fois.
Quand le studio sans code est le meilleur choix
Construire la chaîne ci-dessus demande des jours de travail : stockage, validation, files d’attente, webhooks, nouvelles tentatives et facturation. Si votre objectif est de produire du contenu plutôt qu’une fonctionnalité produit, notre studio vous donne le même rendu OmniHuman 2.0 avec tout cela déjà en place. Nous ne proposons pas nous-mêmes d’API publique ; ce site est conçu pour les créateurs et les marketeurs qui veulent des vidéos finies.
Gérer les échecs et les nouvelles tentatives
Considérez que chaque tâche peut échouer : le fournisseur peut rejeter une entrée, expirer sous la charge ou renvoyer un résultat impossible à télécharger. Gardez une colonne de statut (en file, en cours, terminée, échouée) par tâche, rendez l’étape de finalisation idempotente pour qu’un webhook en double ne soit pas traité deux fois, et remboursez tout solde réservé en cas d’échec.
Interrogez le statut en solution de repli, même si vous utilisez des webhooks. Les machines de développement locales ne peuvent pas les recevoir, et les webhooks de production arrivent parfois en retard.
- Enregistrez l’identifiant de requête du fournisseur avant de répondre à l’utilisateur.
- Re-signez les URL d’entrée avec une durée de validité supérieure au temps d’attente prévu dans la file.
- Journalisez les erreurs du fournisseur telles quelles ; elles indiquent généralement la limite exacte qui a été dépassée.
FAQ
omnihuman2.ai propose-t-il une API publique ?
Non. Nous exécutons le modèle pour les créateurs via le studio web. Les développeurs peuvent accéder à OmniHuman 2 via les fournisseurs de modèles officiels.
Quelle est la durée audio maximale pour l’API OmniHuman 2 ?
300 secondes. Le minimum est de 4 secondes, et le fichier doit être un MP3 ou WAV de moins de 15 Mo.
Quelle résolution l’API renvoie-t-elle ?
La version 2.0 génère nativement en 720p et renvoie un fichier MP4.
L’API est-elle synchrone ?
Généralement non. Les tâches prennent plusieurs minutes, les fournisseurs utilisent donc une file d’attente avec interrogation ou webhooks.
Puis-je envoyer un enregistrement WebM ?
Pas directement. Convertissez-le d’abord en WAV ou MP3 ; la plupart des enregistrements navigateur doivent être réencodés.
Comment l’utilisation est-elle facturée ?
À la seconde de vidéo générée, qui correspond à la durée de votre audio.
Dois-je copier la vidéo générée dans mon propre stockage ?
Oui. Les URL de résultat des fournisseurs peuvent expirer : téléchargez le MP4 dans votre propre stockage dès la fin de la tâche.
Combien de temps prend une tâche en général ?
Cela dépend de la durée du clip et de la charge de la file. Lors de notre propre test, un clip d’environ cinq secondes a été terminé en deux minutes environ de bout en bout : concevez donc votre interface en minutes, pas en secondes.