Bibliothèque Seedance de ressources de personnages numériques
Créez, vérifiez, téléversez et référencez les ressources de personnages numériques Seedance avec les interfaces Action natives.
La bibliothèque de ressources de personnages numériques Seedance gère les ressources de personnes réelles et de personnages virtuels utilisables par Seedance 2.0 et Seedance 2.5. Les interfaces natives conservent Action, Version et leurs structures de requête et de réponse, et sont appelées avec une clé API AGTCloud.
Choisir le type de ressource
| Type de ressource | Méthode de création | Cas d’utilisation | Principales restrictions |
|---|---|---|---|
| Personnage virtuel (AIGC) | Créez directement un conteneur de ressources, puis téléversez | Présentateurs virtuels, personnages et ressources de produits | L’URL de téléversement doit être accessible par le serveur |
| Personne réelle (LivenessFace) | Effectuez d’abord une vérification de présence réelle du visage | Personnages numériques de personnes réelles et représentation de soi | Les ressources doivent correspondre au visage vérifié |
Procédure d’intégration des personnages virtuels
Créer un conteneur de ressources
Appelez CreateAssetGroup pour créer un groupe AIGC et conservez l’ID du groupe renvoyé.
Téléverser une ressource
Téléversez dans le groupe des images, des vidéos ou de l’audio accessibles publiquement. Un téléversement réussi signifie uniquement que la requête a été acceptée ; la ressource passe généralement d’abord à l’état en cours de traitement.
Attendre que la ressource soit utilisable
Consultez régulièrement l’interface de consultation des ressources jusqu’à l’état Active. Avec Failed, lisez les informations d’erreur et n’utilisez plus cette ressource.
Référencer dans une tâche vidéo
Utilisez asset://ASSET_ID ou asset://GROUP_ID comme URL de ressource dans une requête de création native Seedance. Les ressources référencées doivent appartenir au compte actuel et être utilisables.
Procédure d’intégration des personnes réelles
Pour une personne réelle, créez d’abord une session de vérification, guidez l’utilisateur afin qu’il effectue la capture de présence réelle dans un navigateur sur téléphone, puis appelez GetVisualValidateResult pour obtenir l’ID du groupe de ressources ; si la session expire, créez-en une nouvelle.
Après l’obtention du groupe de ressources de personne réelle, vous pouvez téléverser d’autres ressources, mais leur visage doit correspondre à la personne vérifiée. Les ressources ne correspondant pas passent à l’état d’échec avec FaceMismatch.
État et résultats des ressources
Processing: la ressource est encore en cours de traitement. Consultez son état environ toutes les 3 secondes ; évitez les appels sans intervalle.Active: la ressource peut être utilisée pour la génération vidéo.Failed: lisez la cause de l’erreur et arrêtez les consultations régulières ; corrigez la ressource, puis téléversez-la de nouveau.- L’URL signée renvoyée par
GetAssetest valable pendant environ 11,5 heures ; ne la conservez pas comme adresse permanente et ne la diffusez pas publiquement.
Les ressources sont liées au compte de la clé API. L’accès à une ressource inexistante ou appartenant à un autre compte peut entraîner ResourceNotFound. La suppression d’un groupe supprime aussi ses ressources ; avant l’opération, vérifiez l’ID cible et l’étendue de la suppression.
Interfaces associées
- Commencez par Créer un groupe de ressources ou Créer une session de vérification de personne réelle.
- Une fois les ressources utilisables, utilisez Créer une vidéo Seedance 2.5 au format natif ou Créer une vidéo Seedance 2.0 au format natif pour soumettre des références
asset://....