Puedo subir una foto de cara y reutilizarla en Seedance?

Sí. Puedes subir una cara o foto de persona como private asset y usarla en generación de video Seedance. Debe tratarse como generación guiada por referencia, no como face swap garantizado.

Seedance Private Asset Library es lo mismo que face swap?

No. Permite usar assets subidos como referencias reutilizables para mantener consistencia de personaje o sujeto en video generado.

Puedo combinar un asset de persona con una imagen de paisaje?

Sí. Normalmente se pone el asset de persona primero en image_urls y la imagen de paisaje segunda, luego se describen Image 1 e Image 2 en el prompt.

Qué task types de Seedance API admiten private assets?

Funcionan con seedance-2-less-restriction y seedance-2-fast-less-restriction. seedance-2 y seedance-2-fast no admiten asset://.

Cuál es la diferencia entre private assets y auto-upload mode?

Los private assets se gestionan, se suben una vez y se reutilizan. Auto-upload ingiere temporalmente URLs directas para tareas puntuales con auto_upload_assets: true.

Puedo probar private assets en el Playground?

Es principalmente un workflow de API y backend. Si Playground no expone upload, estado, asset:// y task types less-restriction, prueba con cURL, Postman o código backend.

Cómo usar Seedance Private Assets con la Seedance API

Q: Qué es un Seedance private asset?

Un Seedance private asset es una referencia reutilizable subida a PiAPI para generación de video con Seedance. Cuando pasa a Active, puedes referenciarla en tareas futuras con asset:// .

PiAPI ya admite Seedance Private Asset Library, un flujo de Seedance API para subir referencias reutilizables y llamarlas después con asset://<asset_id>.

Seedance Private Asset Library permite subir referencias como caras, personajes, productos, escenas, videos o audio y reutilizarlas en tareas de Seedance API. Es ideal para flujos de consistencia de personaje y referencias reutilizables, no para face swap clásico, inpainting o edición de imagen pixel-perfect.

Puntos clave

Usa private assets cuando una cara, personaje, producto u otro sujeto debe aparecer en varias generaciones futuras.
Usa URLs directas para fondos, escenas, props o referencias que solo se necesitan una vez.
Usa auto_upload_assets: true cuando una referencia temporal del usuario deba importarse para una sola tarea.
El private asset debe estar Active antes de referenciarlo en Seedance.
asset:// funciona con seedance-2-less-restriction y seedance-2-fast-less-restriction, no con los tipos strict.

Respuesta rápida

Los Seedance private assets sirven para referencias reutilizables en la Seedance API. Sube la referencia una vez, espera a que esté Active y úsala en futuras tareas de video con asset://<asset_id>.

Qué son los Seedance Private Assets

Son archivos reutilizables que tu aplicación sube a PiAPI antes de generar video. Después de la carga, PiAPI devuelve un asset_id. Cuando el asset pasa a Active, las solicitudes de Seedance API pueden referenciarlo así. Consulta endpoints, cuotas y ciclo de vida en la documentación de Private Asset Library.

asset://<asset_id>

En lugar de enviar una y otra vez la misma foto de cara, imagen de personaje, toma de producto, video o audio, la subes una vez y reutilizas el ID del asset en múltiples tareas.

Un private asset es una referencia reutilizable para generación de video con Seedance.

Qué problema resuelven

La generación de video con IA puede fallar cuando el mismo sujeto debe mantenerse coherente en varios prompts, escenas o variantes creativas. Una URL directa puede ayudar en una tarea, pero no es ideal cuando se reutiliza muchas veces.

Los casos comunes incluyen mantener una persona o personaje consistente, crear productos tipo avatar o influencer, reutilizar referencias de producto para anuncios, mantener un elenco estable en historias cortas, combinar un sujeto fijo con fondos cambiantes y reducir uploads repetidos en backend.

Para una visión general del modelo, empieza con la guía de Seedance 2.0 API.

Lo que no son

Seedance Private Asset Library no es face swap, inpainting ni composición exacta. Si subes la foto de una persona y un paisaje, Seedance los usa como referencias de generación. El resultado es video generado guiado por referencia, no una edición exacta de la foto.

Private Assets vs URLs directas vs Auto-Upload

Patrón	Mejor para	Ejemplo	Cuándo usarlo
Managed private asset	Personas, personajes, productos o sujetos recurrentes	`asset://asset-123`	Cuando la misma referencia aparecerá en tareas futuras.
Raw URL	Escena, fondo, prop o referencia de una sola vez	`https://your-cdn.com/scene.jpg`	Cuando solo importa para la tarea actual.
Auto-uploaded ephemeral asset	Referencias temporales de usuarios	URL + `auto_upload_assets: true`	Cuando PiAPI debe importarla temporalmente.
Managed cast + raw scenery	Sujeto estable con fondos cambiantes	`asset://person`, `https://.../scene.jpg`	Cuando el sujeto se repite y el fondo no.

Regla simple: si la referencia se reutilizará, conviértela en private asset. Si solo se necesita una vez, usa URL directa o auto-upload.

Cómo funciona el workflow

Sube la referencia reutilizable.
Espera a que el estado sea Active.
Envía una tarea Seedance con asset://<asset_id> en image_urls, video_urls o audio_urls.
En el prompt, referencia las entradas como Image 1, Image 2, Video 1 o Audio 1.
Consulta la tarea hasta que el video esté completo.

El orden importa. Si el private asset va primero en image_urls y la escena va segunda, Image 1 es el asset y Image 2 es el fondo.

{
  "image_urls": [
    "asset://asset-20260607154123-aaaa1",
    "https://your-cdn.com/scenic-background.jpg"
  ]
}

En el prompt puedes escribir:

Image 1 is the person reference. Image 2 is the scenic background.

Ejemplo: persona + paisaje

Puedes subir una foto de una persona como private asset, pasar la escena como URL directa y pedir a Seedance que genere un video usando ambas referencias. El resultado es generación guiada por referencia, no composición exacta.

{
  "image_urls": ["asset://asset-person-reference", "https://your-cdn.com/scenic-background.jpg"],
  "prompt": "Image 1 is the person reference. Image 2 is the scenic background. Generate a cinematic 5-second video of the person from Image 1 standing naturally in the location from Image 2."
}

Ejemplo API

Paso 1: subir un private asset

La URL de origen debe ser pública mientras PiAPI descarga e ingiere el archivo. Mantenerla disponible al menos 24 horas es lo más seguro.

curl --request POST "https://api.piapi.ai/api/v1/asset/upload"
  --header "X-API-Key: $PIAPI_API_KEY"
  --header "Content-Type: application/json"
  --data '{"url":"https://your-cdn.com/person-reference.jpg","asset_type":"Image","name":"main-character"}'

Paso 2: comprobar el estado

curl --request GET "https://api.piapi.ai/api/v1/asset/list?status=active,processing,failed"
  --header "X-API-Key: $PIAPI_API_KEY"

Si sigue Processing, espera y vuelve a comprobar. Si está Failed, revisa el error y sube un archivo corregido.

Paso 3: enviar una tarea Seedance con `asset://`

Usa seedance-2-less-restriction o seedance-2-fast-less-restriction. Los tipos strict seedance-2 y seedance-2-fast no admiten referencias asset://.

Auto-Upload para referencias puntuales

Si una referencia solo se usa en una tarea, activa auto_upload_assets: true. PiAPI puede ingerir temporalmente URLs no asset://, usarlas y limpiarlas después de la ventana de retención.

Buenas prácticas

Reserva private assets para caras, personajes, productos o sujetos de marca recurrentes.
Mantén fondos de una sola vez como URLs directas.
Usa etiquetas claras: Image 1, Image 2, Video 1, Audio 1.
Espera a Active antes de generar.
Planifica cuotas, TTL y consentimiento de las referencias.

Errores comunes

Usar un task type strict

seedance-2 no funciona con asset://; usa una variante less-restriction.

Referenciar el asset demasiado pronto

Flujo correcto: subir asset -> consultar estado -> esperar Active -> enviar tarea Seedance.

Convertir cada fondo en asset

Guarda los private assets para referencias que necesitan consistencia en varias tareas.

FAQ

Qué es un Seedance private asset?

Una referencia reutilizable subida a PiAPI para generación de video con Seedance. Cuando está Active, se usa con asset://<asset_id>.

Puedo reutilizar una foto de cara?

Sí, como generación guiada por referencia. No garantiza face swap exacto.

Es lo mismo que face swap?

No. El objetivo es coherencia de sujeto o personaje en video generado.

Conclusión

Seedance Private Asset Library ofrece una forma más limpia de crear workflows de referencias reutilizables con Seedance API. Sube una referencia, confirma que esté Active y envía una tarea seedance-2-less-restriction con el asset, el prompt y las URLs de una sola vez que necesites. Puedes probar Seedance desde el Seedance workspace.

Fuentes:

PiAPI Private Asset Library docs: https://piapi.ai/docs/seedance-api/private-asset
Seedance 2.0 arXiv page: https://arxiv.org/abs/2604.14148