Vai al contenuto principale
I modelli Seedance 2.0 image- e reference-to-video possono pilotare un video a partire da un volto umano che fornisci. Quando l’API Venice rileva un volto nel media che hai inviato, richiede un’attestazione di consenso una tantum prima di elaborarlo. Si tratta di un requisito del provider per gli input con volti e protegge da usi non consensuali della somiglianza. Questa guida copre esattamente cosa invii, cosa ricevi e come vengono gestite le richieste successive.

Quando si applica il consenso

Il consenso viene richiesto solo quando entrambe le condizioni sono vere:
  1. Il modello è una variante Seedance abilitata per i volti:
    • seedance-2-0-image-to-video, seedance-2-0-reference-to-video
    • seedance-2-0-fast-image-to-video, seedance-2-0-fast-reference-to-video
  2. Il media inviato contiene effettivamente un volto umano rilevabile, in uno qualsiasi di questi campi: image_url, end_image_url, reference_image_urls, reference_video_urls.
Se non c’è alcun volto in nessuno di questi campi, la richiesta procede normalmente senza step di consenso. Il text-to-video non entra mai in questo flusso.
Il consenso non sblocca contenuti vietati. Un minore rilevato combinato con prompt sessualmente suggestivi/NSFW, o la somiglianza di una figura pubblica riconoscibile, viene rifiutato come violazione della content policy (422) e non può essere reso accettabile attestando il consenso.

Il flusso a due chiamate

Chiamata 1 — invia senza consenso

Invia la tua richiesta di generazione come al solito — nessun campo di consenso:
Se viene rilevato un volto e non hai ancora attestato, ricevi un 409 non addebitato:
Nessun credito o pagamento x402 viene addebitato in caso di 409.

Chiamata 2 — reinvia con il consenso

Reinvia lo stesso body della richiesta, aggiungendo un oggetto consents.seedance con tre conferme, tutte true:
Un invio andato a buon fine restituisce la normale risposta della coda:
Quindi esegui il polling di POST /api/v1/video/retrieve con il queue_id come al solito (consulta Generazione video).

L’oggetto di consenso

Tutti e tre i campi devono essere il booleano true. Qualsiasi campo mancante, un false o un campo extra — incluso un consent_version — viene rifiutato con un 400. La versione della policy è sempre impostata dal server; i client non inviano né scelgono mai una versione.

Richieste successive (dedupe)

Se invii esattamente gli stessi byte del media per cui hai già attestato, l’API lo riconosce e procede senza chiedere di nuovo il consenso — puoi omettere consents.seedance nei successivi invii identici. Questa corrispondenza si basa sui byte esatti dell’immagine: ricodifica, ridimensionamento o ritaglio producono byte diversi e attiveranno di nuovo la richiesta di consenso. Una corrispondenza parziale (un input già attestato in precedenza più un nuovo input con volto) richiede comunque un nuovo consents.seedance sul nuovo invio.

Revoca

Per revocare il consenso e cancellare gli asset di volto memorizzati, accedi alla web app Venice (Settings). La revoca non è disponibile tramite API pubblica. Dopo la revoca, la richiesta successiva che usa quel media chiederà nuovamente il consenso.

Pagamento

La decisione sul consenso avviene sempre prima di qualsiasi addebito, per entrambi i metodi di pagamento:
  • API key: un 409/422 viene restituito prima dell’addebito dei crediti; nulla viene fatturato per una richiesta bloccata.
  • x402: l’addebito di consumo viene eseguito solo dopo una generazione riuscita, quindi un 409/422 non liquida nulla. Reinvia con il consenso (e una nuova autorizzazione x402) per procedere.

Riferimento errori

Riferimenti