Passer au contenu principal
Seedance 2.0 génère de la vidéo à partir d’actifs de référence de confiance — un visage, une tenue, un produit, une voix. Pour que la génération reste cohérente et conforme, ces références résident dans une bibliothèque d’actifs privée à laquelle le modèle fait confiance au moment de l’inférence. OrcaRouter expose cette bibliothèque sous /v1/asset. Cette page explique comment fonctionne la bibliothèque et ce qui est requis. Pour les endpoints exacts, les paramètres et une console d’essai, voir API Reference → Seedance Assets.

​
Comment la bibliothèque est structurée

  • Groupe d’actifs (Asset Group) — un conteneur. Pour un groupe humain réel, un groupe correspond à une personne réelle ; pour un groupe virtuel, c’est un regroupement logique (par ex. un personnage).
  • Actif (Asset) — un fichier unique (image, vidéo ou audio) au sein d’un groupe. Seuls les actifs qui atteignent le statut Active peuvent être référencés dans la génération vidéo.
Vous référencez un actif prêt dans une requête vidéo sous la forme asset://<asset_id>.

​
Deux types de groupe

Les opérations d’upload et de gestion sont identiques pour les deux ; ils ne diffèrent que par la façon dont le groupe est créé.
Virtuel (AIGC)Humain réel (LivenessFace)
Utiliser pourPersonnages fictifs / IA, accessoires, scènesLa ressemblance d’une personne réelle
Créé parUn appel de création directUne vérification faciale unique par cette personne
PourquoiAucune identité à protégerDroit à l’image — le consentement est recueilli à la source
Les deux bibliothèques nécessitent des Advanced Creation Rights ; le quota de capacité est partagé entre elles. La bibliothèque humaine réelle est disponible pour les comptes invités.

​
Exigences de fichier d’actif

Les actifs sont fournis sous forme d’URL publiquement accessible (pas d’upload de fichier, pas de base64). Limites :
TypeFormatsContraintes
Imagejpeg, png, webp, bmp, tiff, gif, heic/heifrapport d’aspect (L/H) 0.4–2.5 · 300–6000 px par côté · < 30 MB
Vidéomp4, mov480p/720p/1080p · 2–15 s · rapport 0.4–2.5 · 300–6000 px · pixels totaux 409,600–2,086,876 · 24–60 fps · ≤ 50 MB
Audiowav, mp32–15 s · ≤ 15 MB
Contenu de portrait, bonnes pratiques (pour la cohérence du visage) :
  • Référence corps entier : prise de vue verticale, frontale, de la personne en pied.
  • Gros plan du visage : vertical, expression neutre, cadré au-dessus des épaules, le visage occupant environ les deux tiers du cadre.
Charger plusieurs bonnes références de la même personne dans un même groupe améliore la fidélité avec laquelle la vidéo générée reproduit son visage et ses vêtements.

​
Cycle de vie de l’actif (l’upload est asynchrone)

L’upload d’un actif renvoie immédiatement un asset_id ; le fichier est ensuite prétraité en arrière-plan. Interrogez l’actif jusqu’à ce que son Status se stabilise :
  • Processing — toujours en prétraitement ; continuez à interroger.
  • Active — prêt ; utilisez-le dans la génération vidéo.
  • Failed — le prétraitement l’a rejeté ; inspectez Error (par ex. format/taille, un blocage de modération de contenu, ou — pour les groupes humains réels — FaceMismatch).
Le SLA sur le temps d’upload n’est pas garanti ; les actifs vidéo prennent plus de temps que les images. L’URL de téléchargement signée renvoyée pour un actif est temporaire (~12 heures).

​
Flux de vérification humaine réelle

Un groupe de personne réelle est créé par la personne qui se vérifie une fois elle-même. Votre backend ne manipule jamais ses données faciales — il ne fait qu’orchestrer le flux :
1

Start a session

Votre backend demande à OrcaRouter de démarrer une session de vérification. Vous recevez un lien H5 (une page de vérification faciale hébergée) et un session_id.
2

The person verifies

Vous transmettez le lien H5 à l’utilisateur final. Il l’ouvre sur son propre appareil — aucune connexion OrcaRouter requise — et effectue la vérification faciale. Il autorise une fois ; ultérieurement, de nouveaux looks pour la même personne peuvent être ajoutés au même groupe sans nouvelle vérification.
3

The group is created

En cas de succès, la page de vérification redirige le navigateur de l’utilisateur final vers un callback OrcaRouter (géré automatiquement), et le nouveau groupe est enregistré pour vous. Si vous avez passé un return_url, l’utilisateur revient sur votre page.
4

Poll for the result

Votre backend interroge la session jusqu’à ce que status soit success (avec le nouveau group_id) ou failed. Ensuite, vous chargez des actifs et générez de la vidéo exactement comme pour un groupe virtuel.
Cohérence du visage. Lorsque vous chargez une image dans un groupe humain réel, elle est comparée à la référence vérifiée. Une personne différente (ou plusieurs visages dans une même image) est rejetée — l’actif se résout en Failed / FaceMismatch. Le nom et la description d’un groupe peuvent être définis après la création via l’opération de mise à jour de groupe.

​
Quota

Votre compte a un nombre maximal d’actifs (par défaut 100, tous groupes confondus). Les uploads au-delà du plafond sont rejetés avec 403.

​
Référencer un actif dans la génération vidéo

Une fois qu’un actif est Active, référencez-le par asset://<asset_id> dans le metadata.content[] de la requête vidéo Seedance, et pointez-le dans le prompt par type + position ([Image 1], [Video 1], [Audio 1]) — jamais par l’asset id brut : 
{
  "model": "byteplus/dreamina-seedance-2-0-260128",
  "prompt": "The girl in [Image 1] arranges items on the counter.",
  "metadata": {
    "content": [
      { "type": "image_url", "role": "reference_image",
        "image_url": { "url": "asset://asset-20260318071009-xy98z" } }
    ]
  }
}

​
Suite

  • API Reference → Seedance Assets — chaque endpoint, les paramètres complets et un bac à sable interactif (c’est là que se trouvent les exemples de requête/réponse).
  • Vidéo Seedance — l’endpoint de génération vidéo qui consomme ces actifs.