Posso caricare una foto del volto e riusarla in Seedance?

Sì. Puoi caricare una foto di volto o persona come private asset e usarla nella generazione video Seedance. Va trattata come generazione guidata da riferimento, non come face swap garantito.

Seedance Private Asset Library è uguale al face swap?

No. Consente a Seedance di usare assets caricati come riferimenti generativi riutilizzabili, con focus sulla coerenza del personaggio o soggetto.

Posso combinare un asset persona con un'immagine scenica?

Sì. Di solito l'asset persona va per primo in image_urls e l'immagine scenica per seconda, poi il prompt spiega Image 1 e Image 2.

Quali task type Seedance API supportano private assets?

private assets funzionano con seedance-2-less-restriction e seedance-2-fast-less-restriction. seedance-2 e seedance-2-fast non supportano asset://.

Qual è la differenza tra private assets e auto-upload mode?

private assets sono riferimenti gestiti, caricati una volta e riusati. Auto-upload ingerisce temporaneamente raw URL per task una tantum con auto_upload_assets: true.

Posso testare private assets nel Playground?

private assets sono soprattutto un workflow API e backend. Se il Playground non espone upload, status, asset:// e task type less-restriction, testa con cURL, Postman o backend code.

Come usare Seedance Private Assets con la Seedance API

Q: Cos'è un Seedance private asset?

Un Seedance private asset è un riferimento riutilizzabile caricato su PiAPI per la generazione video Seedance. Quando diventa Active, puoi usarlo nelle task future con asset:// .

PiAPI ora supporta Seedance Private Asset Library, un workflow della Seedance API per caricare riferimenti riutilizzabili e richiamarli in seguito con asset://<asset_id>.

Questa libreria permette di caricare riferimenti di volto, personaggio, prodotto, scena, video o audio e riutilizzarli nelle task Seedance API. È pensata per riferimenti ricorrenti e coerenza dei personaggi, non per face swap classico, inpainting o editing immagine pixel-perfect.

Punti chiave

Usa private assets quando volto, personaggio, prodotto o soggetto devono comparire in più generazioni future.
Usa URL grezzi per sfondi, scene, props o riferimenti usati una sola volta.
Usa auto_upload_assets: true per riferimenti temporanei dell'utente in una singola task.
Il private asset deve essere Active prima di essere usato in Seedance.
asset:// funziona con seedance-2-less-restriction e seedance-2-fast-less-restriction, non con task type strict.

Risposta rapida

I Seedance private assets sono ideali per riferimenti riutilizzabili nella Seedance API. Carica il riferimento una volta, attendi Active, poi usalo nelle task video successive con asset://<asset_id>.

Cosa sono i Seedance Private Assets?

Sono file riutilizzabili che la tua app carica su PiAPI prima della generazione video. Dopo l'upload, PiAPI restituisce un asset_id. Quando l'asset diventa Active, le richieste Seedance API possono usare asset://<asset_id>. Dettagli su endpoint, quote e lifecycle sono nella documentazione Private Asset Library.

Perché servono?

La generazione video AI fatica quando lo stesso soggetto deve rimanere coerente tra prompt, scene o varianti creative. Un URL immagine può bastare per una task, ma non è ideale per riuso frequente.

Casi comuni: mantenere coerente una persona o un personaggio, creare prodotti avatar o influencer, riusare un riferimento prodotto in varianti pubblicitarie, mantenere un cast stabile e ridurre upload ripetuti nel backend. Per una panoramica del modello leggi la guida Seedance 2.0 API.

Cosa non sono

Seedance Private Asset Library non è face swap, inpainting o compositing esatto. Seedance usa gli input come riferimenti generativi. Il risultato è un video guidato da reference, non un edit preciso dell'immagine.

Private Assets vs URL grezzi vs Auto-Upload

Pattern	Ideale per	Esempio	Quando usarlo
Managed private asset	Persone, personaggi, prodotti o soggetti ricorrenti	`asset://asset-123`	Quando lo stesso riferimento sarà usato in più task.
Raw URL	Sfondo, scena o prop usa e getta	`https://your-cdn.com/scene.jpg`	Quando serve solo per la task attuale.
Auto-uploaded ephemeral asset	Riferimenti utente temporanei	URL + `auto_upload_assets: true`	Quando PiAPI deve ingerire temporaneamente un file.

Regola semplice: se il riferimento verrà riusato, crea un private asset; se serve una volta sola, usa raw URL o auto-upload.

Workflow

Carica il riferimento riutilizzabile.
Attendi lo stato Active.
Invia una task Seedance con asset://<asset_id> in image_urls, video_urls o audio_urls.
Nel prompt usa Image 1, Image 2, Video 1 o Audio 1 secondo l'ordine degli input.
Fai polling finché il video è completato.

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

Esempio API

Carica il riferimento con https://api.piapi.ai/api/v1/asset/upload, controlla lo stato con l'endpoint asset list e, quando è Active, usa asset://<asset_id> in una task seedance-2-less-restriction o seedance-2-fast-less-restriction. Le varianti strict come seedance-2 e seedance-2-fast non supportano private asset references.

Best practice

Riserva private assets a volti, personaggi, prodotti o soggetti di brand ricorrenti.
Mantieni sfondi usa e getta come URL grezzi.
Usa label chiare nel prompt, come Image 1 e Image 2.
Aspetta Active prima di generare.
Pianifica quote, TTL e consenso per riferimenti degli utenti.

FAQ

Cos'è un Seedance private asset?

È un riferimento riutilizzabile caricato su PiAPI per la generazione video Seedance. Quando è Active, può essere usato con asset://<asset_id>.

Posso riusare una foto del volto?

Sì, come generazione guidata da riferimento. Non garantisce face swap esatto.

Conclusione

Seedance Private Asset Library rende più pulito costruire workflow di riferimenti riutilizzabili con Seedance API. Carica un riferimento, conferma Active, poi invia una task less-restriction con asset, prompt e URL usa e getta. Puoi provarlo dal Seedance workspace.