Comment utiliser un visage réel dans Seedance 2.5 avec les actifs réels d'AIHubMix

Les vidéos AI deviennent beaucoup plus utiles lorsque la personne à l'écran reste reconnaissable d'une scène à l'autre. Les actifs réels d'AIHubMix offrent un moyen basé sur le consentement d'utiliser un visage approuvé dans la génération de vidéos Seedance tout en maintenant l'autorisation, le traitement des actifs et la génération comme des étapes distinctes et vérifiables.

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

Qu'est-ce qu'une vidéo réelle ?

Une vidéo réelle 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 changer le décor, les vêtements, l'action, le mouvement de la caméra, la voix ou la langue tout en préservant l'apparence reconnaissable de la personne.

Cela diffère de la génération ordinaire de texte à vidéo. Une invite textuelle décrit ce qui doit se passer, mais elle n'identifie pas de manière fiable une personne réelle spécifique. Un actif réel donne au modèle une référence visuelle approuvée qui peut être réutilisée dans plusieurs vidéos.

Les applications typiques incluent les avatars de créateurs, les présentateurs virtuels, les explications de produits, les campagnes localisées, les vidéos de formation, les personnages de marque et le contenu social de courte durée.

Comment fonctionne le flux de travail d'AIHubMix

Le flux de travail comporte cinq étapes principales :

Créer un groupe d'actifs pour une personne.
Demander à la personne sur l'image de compléter le flux d'autorisation.
Ajouter un portrait et attendre que l'actif soit actif.
Référencer l'actif actif avec un asset:// URI.
Soumettre une tâche vidéo Seedance et la vérifier jusqu'à son achèvement.

La séparation est délibérée. L'autorisation se fait avant la génération, la préparation de l'actif peut être vérifiée indépendamment, et chaque étape importante expose un statut que votre application peut surveiller.

Pourquoi utiliser AIHubMix ?

Une API pour l'ensemble du flux de travail

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

Autorisation explicite

La personne sur le 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 réelle réutilisable.

Actifs d'identité réutilisables

Après qu'une image soit devenue active, les applications peuvent réutiliser son ID d'actif dans plusieurs demandes vidéo au lieu de télécharger l'image originale à chaque fois.

Génération prête pour Seedance

Le point de terminaison natif de 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 rapport d'aspect et la génération audio.

États observables et adaptés à la production

Votre application peut attendre les états verified, active et completed plutôt que de deviner si une opération est terminée. Cela facilite la mise en œuvre des réessais et de la gestion des erreurs.

Tutoriel étape par étape

É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 d'image HTTPS directe. L'URL doit renvoyer le fichier image sans connexion ou en-têtes personnalisés et doit rester disponible pendant qu'AIHubMix le 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 clair de la même personne qui complète l'autorisation

Étape 2 : Créer un groupe d'actifs réels

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":"Mon actif humain réel"}'

Enregistrez l'id retourné, 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'ID de 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 une verification_url temporaire. Ouvrez cette URL dans un navigateur et demandez à la personne sur le portrait de revoir l'objectif et de compléter le flux d'autorisation.

L'URL est sensible et temporaire. Ne la publiez pas, ne l'engagez 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

Après que la personne ait terminé le flux 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"

Continuez uniquement lorsque la session de vérification est verified et que le groupe d'actifs est active. Une page d'erreur du navigateur ne détermine pas le résultat final ; utilisez le statut de 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'ID d'actif retourné 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"

Utilisez l'actif uniquement lorsque son statut est active. creating et processing signifient qu'il n'est pas encore prêt.

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

L'actif humain réel appartient à input_references[].url. Il ne doit pas être collé 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\":\"Un vlog vertical réaliste. La personne sourit, fait un signe de la main et dit en japonais : やっほー！今日も笑顔でね！ Gardez le visage cohérent, synchronisez le mouvement des lèvres, utilisez un mouvement naturel des mains et n'ajoutez pas de sous-titres.\",
    \"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 ID de tâche vidéo. Interrogez GET /ai/v1/videos/{id} jusqu'à ce que la tâche soit completed, puis téléchargez rapidement la sortie car les URL vidéo 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 intégrations plus anciennes 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 demande. Avant une utilisation en production, vérifiez le schéma du modèle en direct pour les durées, résolutions, types de références, comportements audio et chemins de point de terminaison pris en charge.

Meilleures pratiques pour les invites

Décrivez l'environnement, l'action, le timing, le mouvement de la caméra, la voix et les contraintes. Une invite solide pourrait spécifier un kimono, des cerisiers en fleurs, un mouvement de main doux, un dialogue japonais, un mouvement des lèvres synchronisé, un mouvement naturel des cheveux et pas de sous-titres.

Cinq secondes fonctionnent bien pour un court salut. Si la vidéo comprend plusieurs actions ou une longue phrase, utilisez une durée plus longue ou raccourcissez le script afin que la performance ne semble pas précipitée.

Utilisez une référence d'identité pour un test simple. Ajoutez des références supplémentaires uniquement lorsque le schéma du modèle les prend en charge et que chaque actif appartient au même groupe d'actifs.

Problèmes courants

Le groupe n'est pas actif : attendez que la session de vérification devienne verified et que le groupe devienne active.
L'actif est en cours de traitement : interrogez l'ID d'actif original ; ne créez pas de doublons avec un nouvel ID.
L'URL de l'image échoue : utilisez une URL de fichier HTTPS publique, pas un chemin local, une page de connexion ou une page de partage.
La vidéo rejette l'actif : confirmez que l'actif est active, appartient au même compte et utilise le bon type de média.
Le terrain de jeu ne montre pas asset:// : Le téléchargement d'image dans le terrain de jeu et l'enregistrement d'actifs réels sont des flux de travail séparés. Utilisez le champ de référence API pour les actifs enregistrés.

Liste de contrôle finale

Clé API configurée en toute sécurité.
Groupe d'actifs créé.
Autorisation de la personne complétée.
Le statut du groupe est active.
Le statut de l'actif portrait est active.
La demande vidéo utilise asset://<asset_id>.
La tâche vidéo est interrogée jusqu'à completed.

Les actifs réels d'AIHubMix offrent aux développeurs un moyen pratique de créer des expériences vidéo basées sur le consentement et cohérentes en matière d'identité avec Seedance. Commencez par un portrait approuvé et un court clip de test, puis étendez le même flux de travail aux outils de créateurs, au contenu de marque et aux applications de production.