Posso enviar uma foto de rosto e reutilizá-la no Seedance?

Sim. Você pode enviar uma foto de rosto ou pessoa como private asset e usá-la na geração de vídeo Seedance. Trate isso como geração guiada por referência, não como face swap garantido.

Seedance Private Asset Library é o mesmo que face swap?

Não. Ela permite que Seedance use assets enviados como referências reutilizáveis de geração, com foco em consistência de personagem ou assunto.

Posso combinar um asset de pessoa com uma imagem de paisagem?

Sim. Normalmente o asset de pessoa fica primeiro em image_urls e a imagem de paisagem em segundo, com o prompt explicando Image 1 e Image 2.

Quais task types da Seedance API suportam private assets?

private assets funcionam com seedance-2-less-restriction e seedance-2-fast-less-restriction. seedance-2 e seedance-2-fast não suportam asset://.

Qual é a diferença entre private assets e auto-upload mode?

private assets são referências gerenciadas, enviadas uma vez e reutilizadas. Auto-upload ingere URLs diretas temporariamente para tarefas únicas com auto_upload_assets: true.

Posso testar private assets no Playground?

private assets são principalmente um fluxo de API e backend. Se o Playground não expõe upload, status, asset:// e task types less-restriction, teste com cURL, Postman ou código backend.

Como usar Seedance Private Assets com a Seedance API

Q: O que é um Seedance private asset?

Um Seedance private asset é uma referência reutilizável enviada à PiAPI para geração de vídeo Seedance. Quando fica Active, você pode usá-la em tarefas futuras com asset:// .

A PiAPI agora oferece suporte à Seedance Private Asset Library, um fluxo da Seedance API para enviar referências reutilizáveis e chamá-las depois com asset://<asset_id>.

Essa biblioteca permite enviar referências de rosto, personagem, produto, cena, vídeo ou áudio e reutilizá-las em tarefas da Seedance API. Ela é indicada para consistência de personagem e referências recorrentes, não para face swap clássico, inpainting ou edição de imagem pixel-perfect.

Pontos principais

Use private assets quando um rosto, personagem, produto ou assunto precisar aparecer em várias gerações futuras.
Use URLs diretas para cenários, fundos, objetos ou referências usadas uma única vez.
Use auto_upload_assets: true quando uma referência temporária do usuário deve ser ingerida para uma única tarefa.
O asset precisa estar Active antes de ser usado em uma tarefa Seedance.
asset:// funciona com seedance-2-less-restriction e seedance-2-fast-less-restriction, não com task types strict.

Resposta rápida

Seedance private assets são ideais para referências reutilizáveis na Seedance API. Envie a referência uma vez, espere o status Active e use asset://<asset_id> nas próximas tarefas de vídeo.

O que são Seedance Private Assets?

São arquivos reutilizáveis que seu aplicativo envia para a PiAPI antes da geração de vídeo. Depois do upload, a PiAPI retorna um asset_id. Quando o asset fica Active, suas requisições Seedance API podem usá-lo com asset://<asset_id>. Veja endpoints, cotas e ciclo de vida na documentação da Private Asset Library.

Para que servem?

A geração de vídeo por IA tem dificuldade quando o mesmo assunto precisa continuar consistente em vários prompts, cenas ou variações criativas. Uma URL direta ajuda em uma tarefa, mas não é ideal para reutilização frequente.

Casos comuns incluem manter a mesma pessoa ou personagem, criar produtos de avatar ou influencer, reutilizar uma referência de produto em anúncios, manter elenco estável em histórias curtas e reduzir uploads repetidos no backend. Para uma visão geral do modelo, leia o Seedance 2.0 API guide.

O que Private Assets não são

Seedance Private Asset Library não é face swap, inpainting nem composição exata. Seedance usa os arquivos enviados como referências de geração. O resultado é vídeo gerado guiado por referência, não substituição precisa de rosto ou edição pixel a pixel.

Private Assets vs URLs diretas vs Auto-Upload

Padrão	Melhor para	Exemplo	Quando usar
Managed private asset	Pessoas, personagens, produtos ou assuntos recorrentes	`asset://asset-123`	Quando a mesma referência aparecerá em várias tarefas.
Raw URL	Fundo, cena ou objeto de uso único	`https://your-cdn.com/scene.jpg`	Quando a referência só importa para a tarefa atual.
Auto-uploaded ephemeral asset	Referências temporárias do usuário	URL + `auto_upload_assets: true`	Quando a PiAPI deve ingerir algo temporariamente.

Regra simples: se a referência será reutilizada, transforme-a em private asset; se for usada uma vez, mantenha uma URL direta ou use auto-upload.

Fluxo de trabalho

Envie a referência reutilizável.
Aguarde o status Active.
Envie uma tarefa Seedance com asset://<asset_id> em image_urls, video_urls ou audio_urls.
No prompt, use Image 1, Image 2, Video 1 ou Audio 1 conforme a ordem dos inputs.
Consulte a tarefa até o vídeo ficar pronto.

{
  "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."
}

Exemplo de API

Envie a referência com https://api.piapi.ai/api/v1/asset/upload, consulte o status com o endpoint de lista de assets e, quando estiver Active, use asset://<asset_id> em uma tarefa seedance-2-less-restriction ou seedance-2-fast-less-restriction. Variantes strict como seedance-2 e seedance-2-fast não aceitam private asset references.

Boas práticas

Reserve private assets para rostos, personagens, produtos ou assuntos de marca recorrentes.
Mantenha fundos de uso único como URLs diretas.
Escreva prompts com rótulos claros como Image 1 e Image 2.
Espere Active antes de gerar.
Planeje cotas, TTL e consentimento para referências de usuários.

FAQ

O que é um Seedance private asset?

É uma referência reutilizável enviada à PiAPI para geração de vídeo Seedance. Quando fica Active, pode ser usada com asset://<asset_id>.

Posso reutilizar uma foto de rosto?

Sim, como geração guiada por referência. Isso não garante face swap exato.

Conclusão

Seedance Private Asset Library oferece uma forma mais limpa de criar fluxos de referências reutilizáveis com a Seedance API. Envie uma referência, confirme que está Active e crie uma tarefa less-restriction com o asset, o prompt e URLs de uso único. Você pode testar no Seedance workspace.