Comment utiliser un vrai visage dans Seedance 2.5 avec les ressources humaines réelles d'AIHubMix

La vidéo générée par IA devient beaucoup plus utile lorsque la personne à l'écran reste reconnaissable d'une scène à l'autre. Les ressources humaines réelles d'AIHubMix offrent un moyen fondé sur le consentement d'utiliser un visage approuvé dans la génération vidéo Seedance, tout en séparant clairement les étapes d'autorisation, de traitement de la ressource et de génération, chacune pouvant être vérifiée.

Ce guide explique ce qu'est une vidéo avec un humain réel, comment fonctionne le workflow d'AIHubMix, pourquoi il est utile et comment créer une vidéo Seedance 2.5 à partir d'un vrai visage. Il explique également la différence entre l'API native Seedance 2.5 et les intégrations compatibles avec Seedance 2.0.

Qu'est-ce qu'une vidéo avec un humain réel ?

Une vidéo avec un humain réel est une vidéo générée par IA qui utilise une personne autorisée comme référence d'identité. Le modèle peut modifier le décor, les vêtements, l'action, le mouvement de caméra, la voix ou la langue, tout en préservant l'apparence reconnaissable de la personne.

Ce procédé diffère de la génération classique de texte vers vidéo. Une invite textuelle décrit ce qui doit se passer, mais elle ne permet pas d'identifier de manière fiable une personne réelle précise. Une ressource humaine réelle fournit au modèle une référence visuelle approuvée, réutilisable dans plusieurs vidéos.

Les applications typiques incluent les avatars de créateurs, les présentateurs virtuels, les vidéos explicatives de produits, les campagnes localisées, les vidéos de formation, les personnages de marque et les contenus courts pour les réseaux sociaux.

Fonctionnement du workflow AIHubMix

Le workflow comporte cinq étapes principales :

Créer un groupe de ressources pour une personne.
Demander à la personne sur l'image de compléter le processus d'autorisation.
Ajouter un portrait et attendre que la ressource soit active.
Référencer la ressource active à l'aide d'un URI asset://.
Soumettre une tâche vidéo Seedance et l'interroger jusqu'à son achèvement.

Cette séparation est délibérée. L'autorisation intervient avant la génération, la disponibilité de la ressource peut être vérifiée indépendamment, et chaque étape importante expose un statut que votre application peut surveiller.

Pourquoi utiliser AIHubMix ?

Une seule API pour l'ensemble du workflow

AIHubMix fournit des points de terminaison pour les groupes de ressources, les sessions de vérification, les ressources humaines et la génération vidéo asynchrone. Le même compte et la même clé API permettent de gérer l'ensemble du pipeline.

Autorisation explicite

La personne du portrait complète la page d'autorisation. Cela crée une étape de consentement claire avant que l'image ne soit utilisée comme référence humaine réelle réutilisable.

Ressources d'identité réutilisables

Une fois qu'une image est active, les applications peuvent réutiliser son identifiant de ressource dans plusieurs requêtes vidéo, au lieu de téléverser l'image originale à chaque fois.

Génération prête pour Seedance

Le point de terminaison natif Seedance 2.5 prend en charge les références de texte, d'image, de vidéo et d'audio, ainsi que des contrôles pour la durée, la résolution, le format d'image et la génération audio.

États observables, adaptés à la production

Votre application peut attendre verified, active et completed, au lieu de deviner si une opération est terminée. Cela facilite la mise en place des nouvelles tentatives et de la gestion des erreurs.

Tutoriel pas à pas

Étape 1 : préparer une clé API et un portrait

Créez une clé API dans la console AIHubMix. Gardez-la privée. Dans le Terminal, définissez-la comme variable d'environnement :

export AIHUBMIX_API_KEY="your_api_key"

Préparez une URL HTTPS directe vers l'image. Cette URL doit renvoyer le fichier image sans connexion ni en-têtes personnalisés, et doit rester disponible pendant qu'AIHubMix la traite.

Exigences recommandées pour l'image :

JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC ou HEIF
Moins de 30 Mo
Largeur et hauteur supérieures à 300 pixels et inférieures à 6000 pixels
Rapport d'aspect supérieur à 0,4 et inférieur à 2,5
Un portrait net de la personne qui complète l'autorisation

Étape 2 : créer un groupe de ressources humaines réelles

Exécutez cette commande dans le Terminal :

curl -sS -X POST "https://aihubmix.com/ai/v1/asset-groups" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"My real-human asset"}'

Enregistrez l'id renvoyé, qui ressemble à ag_... :

GROUP_ID="ag_your_group_id"

Un nouveau groupe commence normalement avec pending_auth.

Étape 3 : créer une session d'autorisation

Utilisez l'identifiant du groupe pour demander une session de vérification :

curl -sS -X POST \
  "https://aihubmix.com/ai/v1/asset-groups/$GROUP_ID/verification-sessions" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

La réponse contient un verification_url temporaire. Ouvrez cette URL dans un navigateur et demandez à la personne du portrait de prendre connaissance de l'objectif et de compléter le processus d'autorisation.

Cette URL est sensible et temporaire. Ne la publiez pas, ne la validez pas dans un dépôt et ne l'incluez pas dans des captures d'écran.

Étape 4 : vérifier l'autorisation et le statut du groupe

Une fois que la personne a terminé le processus dans le navigateur, interrogez les deux ressources :

curl -sS "https://aihubmix.com/ai/v1/verification-sessions/$SESSION_ID" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

curl -sS "https://aihubmix.com/ai/v1/asset-groups/$GROUP_ID" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

Ne poursuivez que lorsque la session de vérification est verified et que le groupe de ressources est active. Une page d'erreur du navigateur ne détermine pas le résultat final ; utilisez le statut fourni par l'API.

Étape 5 : ajouter le portrait

Soumettez l'URL directe de l'image :

curl -sS -X POST \
  "https://aihubmix.com/ai/v1/asset-groups/$GROUP_ID/assets" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: portrait-001" \
  -d '{
    "url":"https://cdn.example.com/portrait.jpg",
    "asset_type":"image",
    "client_reference_id":"portrait-001"
  }'

Enregistrez l'identifiant de ressource renvoyé et interrogez-le :

ASSET_ID="ast_your_asset_id"
curl -sS "https://aihubmix.com/ai/v1/assets/$ASSET_ID" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

N'utilisez la ressource que lorsque son statut est active. creating et processing signifient qu'elle n'est pas encore prête.

Étape 6 : générer une vidéo Seedance 2.5

La ressource humaine réelle doit figurer dans input_references[].url. Elle ne doit pas être insérée dans le texte de l'invite :

curl -sS -X POST "https://aihubmix.com/ai/v1/videos" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\":\"doubao-seedance-2-5-260628\",
    \"prompt\":\"A realistic vertical vlog. The person smiles, waves, and says in Japanese: やっほー！今日も笑顔でね！ Keep the face consistent, synchronize lip movement, use natural hand motion, and add no subtitles.\",
    \"duration\":5,
    \"resolution\":\"720p\",
    \"aspect_ratio\":\"3:4\",
    \"generate_audio\":true,
    \"input_references\":[{\"type\":\"image_url\",\"url\":\"asset://$ASSET_ID\"}]
  }"

La réponse renvoie un identifiant de tâche vidéo. Interrogez GET /ai/v1/videos/{id} jusqu'à ce que la tâche soit completed, puis téléchargez rapidement le résultat, car les URL des vidéos sont temporaires.

Seedance 2.5 et Seedance 2.0

Seedance 2.5 utilise le point de terminaison natif /ai/v1/videos décrit ci-dessus. Les anciennes intégrations peuvent utiliser Seedance 2.0 avec le protocole compatible /v1/videos et une structure de contenu différente.

Ne mélangez pas les deux formats de requête. Avant toute utilisation en production, vérifiez le schéma du modèle en service pour les durées prises en charge, les résolutions, les types de référence, le comportement audio et les chemins des points de terminaison.

Bonnes pratiques pour les invites

Décrivez l'environnement, l'action, le rythme, le mouvement de caméra, la voix et les contraintes. Une invite efficace peut préciser un kimono, des fleurs de cerisier qui tombent, un geste de la main doux, des dialogues en japonais, une synchronisation labiale, un mouvement naturel des cheveux et l'absence de sous-titres.

Cinq secondes conviennent bien à une courte salutation. Si la vidéo comprend plusieurs actions ou une phrase longue, utilisez une durée plus longue ou raccourcissez le script afin que la prestation ne paraisse pas précipitée.

Utilisez une seule référence d'identité pour un test simple. N'ajoutez des références supplémentaires que si le schéma du modèle les prend en charge et si chaque ressource appartient au même groupe de ressources.

Problèmes courants

Le groupe n'est pas actif : attendez que la session de vérification passe à verified et que le groupe passe à active.
La ressource est en cours de traitement : interrogez l'identifiant de ressource d'origine ; ne créez pas de doublons avec un nouvel identifiant.
L'URL de l'image échoue : utilisez une URL HTTPS publique vers un fichier, et non un chemin local, une page de connexion ou une page de partage.
La vidéo rejette la ressource : vérifiez que la ressource est active, qu'elle appartient au même compte et qu'elle utilise le bon type de média.
Le Playground n'affiche pas asset:// : le téléversement d'image dans le Playground et l'enregistrement de ressources humaines réelles sont des workflows distincts. Utilisez le champ de référence de l'API pour les ressources enregistrées.

Liste de contrôle finale

Clé API configurée de manière sécurisée.
Groupe de ressources créé.
Autorisation de la personne effectuée.
Le statut du groupe est active.
Le statut de la ressource portrait est active.
La requête vidéo utilise asset://<asset_id>.
La tâche vidéo est interrogée jusqu'à ce qu'elle soit completed.

Les ressources humaines réelles d'AIHubMix offrent aux développeurs un moyen concret de créer des expériences vidéo fondées sur le consentement et une identité cohérente avec Seedance. Commencez par un portrait approuvé et un court clip de test, puis étendez ce même workflow aux outils pour créateurs, aux contenus de marque et aux applications de production.