Saltar al contenido principal
Seedance 2.0 genera vídeo a partir de assets de referencia de confianza — una cara, un atuendo, un producto, una voz. Para mantener la generación coherente y conforme, esas referencias viven en una biblioteca de assets privada en la que el modelo confía en el momento de la inferencia. OrcaRouter expone esa biblioteca bajo /v1/asset. Esta página explica cómo funciona la biblioteca y qué se requiere. Para los endpoints exactos, los parámetros y una consola para probarlo, consulta API Reference → Seedance Assets.

​
Cómo se estructura la biblioteca

  • Grupo de assets (Asset Group) — un contenedor. Para un grupo de personas reales, un grupo corresponde a una persona real; para un grupo virtual, es una agrupación lógica (p. ej. un personaje).
  • Asset — un único archivo (imagen, vídeo o audio) dentro de un grupo. Solo los assets que alcanzan el estado Active pueden referenciarse en la generación de vídeo.
Referencias un asset listo en una solicitud de vídeo como asset://<asset_id>.

​
Dos tipos de grupo

Las operaciones de subida y gestión son idénticas para ambos; solo difieren en cómo se crea el grupo.
Virtual (AIGC)Persona real (LivenessFace)
Usar paraPersonajes ficticios / de IA, accesorios, escenasLa imagen de una persona real
Creado porUna llamada de creación directaUna verificación facial única por esa persona
Por quéNo hay identidad que protegerDerechos de imagen — el consentimiento se captura en el origen
Ambas bibliotecas requieren Advanced Creation Rights; la cuota de capacidad se comparte entre ellas. La biblioteca de personas reales está disponible para cuentas invitadas.

​
Requisitos de los archivos de asset

Los assets se proporcionan como una URL de acceso público (sin subida de archivos, sin base64). Límites:
TipoFormatosRestricciones
Imagenjpeg, png, webp, bmp, tiff, gif, heic/heifrelación de aspecto (W/H) 0.4–2.5 · 300–6000 px por lado · < 30 MB
Vídeomp4, mov480p/720p/1080p · 2–15 s · relación 0.4–2.5 · 300–6000 px · píxeles totales 409,600–2,086,876 · 24–60 fps · ≤ 50 MB
Audiowav, mp32–15 s · ≤ 15 MB
Contenido de retrato, mejores prácticas (para la coherencia facial):
  • Referencia de cuerpo completo: toma vertical, frontal y de cuerpo completo de la persona.
  • Primer plano facial: vertical, expresión neutra, encuadrado por encima de los hombros, con la cara ocupando aproximadamente dos tercios del encuadre.
Subir varias buenas referencias de la misma persona a un mismo grupo mejora la fidelidad con que el vídeo generado reproduce su cara y su vestimenta.

​
Ciclo de vida del asset (la subida es asíncrona)

Subir un asset devuelve de inmediato un asset_id; el archivo se preprocesa después en segundo plano. Consulta el asset hasta que su Status se estabilice:
  • Processing — aún preprocesando; sigue consultando.
  • Active — listo; úsalo en la generación de vídeo.
  • Failed — el preprocesamiento lo rechazó; revisa Error (p. ej. formato/tamaño, un bloqueo por moderación de contenido o — en grupos de personas reales — FaceMismatch).
El tiempo de subida no tiene SLA garantizado; los assets de vídeo tardan más que las imágenes. La URL de descarga firmada que se devuelve para un asset es temporal (~12 horas).

​
Flujo de verificación de persona real

Un grupo de persona real se crea cuando la persona se verifica a sí misma una vez. Tu backend nunca maneja sus datos faciales — solo orquesta el flujo:
1

Iniciar una sesión

Tu backend pide a OrcaRouter que inicie una sesión de verificación. Recibes de vuelta un enlace H5 (una página alojada de verificación facial) y un session_id.
2

La persona se verifica

Entregas el enlace H5 al usuario final. Lo abre en su propio dispositivo — sin necesidad de iniciar sesión en OrcaRouter — y completa la verificación facial. Autoriza una vez; después, nuevos looks de la misma persona pueden añadirse al mismo grupo sin volver a verificar.
3

Se crea el grupo

Al tener éxito, la página de verificación redirige el navegador del usuario final de vuelta a un callback de OrcaRouter (gestionado automáticamente), y el nuevo grupo queda registrado para ti. Si pasaste un return_url, el usuario regresa a tu página.
4

Consultar el resultado

Tu backend consulta la sesión hasta que status sea success (con el nuevo group_id) o failed. Luego subes assets y generas vídeo exactamente igual que con un grupo virtual.
Coherencia facial. Cuando subes una imagen a un grupo de persona real, se compara con la referencia verificada. Una persona distinta (o varias caras en una misma imagen) se rechaza — el asset queda como Failed / FaceMismatch. El nombre y la descripción de un grupo pueden establecerse tras la creación mediante la operación de actualización de grupo.

​
Cuota

Tu cuenta tiene un número máximo de assets (por defecto 100, en todos los grupos). Las subidas que superen el límite se rechazan con 403.

​
Referenciar un asset en la generación de vídeo

Una vez que un asset está Active, referéncialo con asset://<asset_id> en el metadata.content[] de la solicitud de vídeo de Seedance, y apunta a él en el prompt por tipo + posición ([Image 1], [Video 1], [Audio 1]) — nunca por el id de asset en crudo: 
{
  "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" } }
    ]
  }
}

​
Siguiente

  • API Reference → Seedance Assets — cada endpoint, los parámetros completos y un playground interactivo (aquí es donde están los ejemplos de solicitud/respuesta).
  • Seedance Video — el endpoint de generación de vídeo que consume estos assets.