Come utilizzare un volto reale in Seedance 2.5 con le risorse umane reali di AIHubMix

I video AI diventano molto più utili quando la persona sullo schermo rimane riconoscibile da una scena all'altra. Le risorse umane reali di AIHubMix forniscono un modo basato sul consenso per utilizzare un volto approvato nella generazione di video Seedance, mantenendo l'autorizzazione, l'elaborazione delle risorse e la generazione come passaggi separati e verificabili.

Questa guida spiega cos'è un video umano reale, come funziona il flusso di lavoro di AIHubMix, perché è utile e come creare un video Seedance 2.5 da un volto reale. Spiega anche la differenza tra l'API nativa di Seedance 2.5 e le integrazioni compatibili di Seedance 2.0.

Cos'è un video umano reale?

Un video umano reale è un video generato dall'AI che utilizza una persona autorizzata come riferimento identitario. Il modello può cambiare l'ambientazione, l'abbigliamento, l'azione, il movimento della telecamera, la voce o la lingua, mantenendo l'aspetto riconoscibile della persona.

Questo è diverso dalla generazione di video ordinaria da testo a video. Un prompt testuale descrive cosa dovrebbe accadere, ma non identifica in modo affidabile una persona reale specifica. Una risorsa umana reale fornisce al modello un riferimento visivo approvato che può essere riutilizzato in più video.

Le applicazioni tipiche includono avatar di creatori, presentatori virtuali, spiegazioni di prodotti, campagne localizzate, video di formazione, personaggi di marca e contenuti social brevi.

Come funziona il flusso di lavoro di AIHubMix

Il flusso di lavoro ha cinque fasi principali:

Creare un gruppo di risorse per una persona.
Chiedere alla persona nell'immagine di completare il flusso di autorizzazione.
Aggiungere un ritratto e attendere fino a quando la risorsa è attiva.
Fare riferimento alla risorsa attiva con un asset:// URI.
Inviare un'attività video Seedance e interrogarla fino al completamento.

La separazione è deliberata. L'autorizzazione avviene prima della generazione, la prontezza della risorsa può essere controllata in modo indipendente e ogni fase importante espone uno stato che la tua applicazione può monitorare.

Perché utilizzare AIHubMix?

Un'API per l'intero flusso di lavoro

AIHubMix fornisce endpoint per gruppi di risorse, sessioni di verifica, risorse umane e generazione video asincrona. Lo stesso account e la stessa chiave API possono gestire l'intero pipeline.

Autorizzazione esplicita

La persona nel ritratto completa la pagina di autorizzazione. Questo crea un chiaro passaggio di consenso prima che l'immagine venga utilizzata come riferimento umano riutilizzabile.

Risorse identitarie riutilizzabili

Dopo che un'immagine diventa attiva, le applicazioni possono riutilizzare il suo ID risorsa in più richieste video invece di caricare l'immagine originale ogni volta.

Generazione pronta per Seedance

L'endpoint nativo di Seedance 2.5 supporta riferimenti a testo, immagini, video e audio, oltre a controlli per durata, risoluzione, rapporto d'aspetto e generazione audio.

Stati osservabili e adatti alla produzione

La tua applicazione può attendere verified, active e completed invece di indovinare se un'operazione è terminata. Questo rende più facile implementare ripetizioni e gestione degli errori.

Tutorial passo-passo

Passo 1: Prepara una chiave API e un ritratto

Crea una chiave API nella Console AIHubMix. Tienila privata. In Terminal, impostala come variabile d'ambiente:

export AIHUBMIX_API_KEY="your_api_key"

Prepara un URL di immagine HTTPS diretto. L'URL deve restituire il file immagine senza login o intestazioni personalizzate e deve rimanere disponibile mentre AIHubMix lo elabora.

Requisiti di immagine consigliati:

JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC o HEIF
Inferiore a 30 MB
Larghezza e altezza superiori a 300 pixel e inferiori a 6000 pixel
Rapporto d'aspetto superiore a 0.4 e inferiore a 2.5
Un ritratto chiaro della stessa persona che completa l'autorizzazione

Passo 2: Crea un gruppo di risorse umane reali

Esegui questo comando in Terminal:

curl -sS -X POST "https://aihubmix.com/ai/v1/asset-groups" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"La mia risorsa umana reale"}'

Salva l'id restituito, che appare come ag_...:

GROUP_ID="ag_your_group_id"

Un nuovo gruppo di solito inizia con pending_auth.

Passo 3: Crea una sessione di autorizzazione

Usa l'ID del gruppo per richiedere una sessione di verifica:

curl -sS -X POST \
  "https://aihubmix.com/ai/v1/asset-groups/$GROUP_ID/verification-sessions" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

La risposta contiene un verification_url temporaneo. Apri quell'URL in un browser e chiedi alla persona nel ritratto di rivedere lo scopo e completare il flusso di autorizzazione.

L'URL è sensibile e temporaneo. Non pubblicarlo, non commetterlo in un repository e non includerlo negli screenshot.

Passo 4: Verifica l'autorizzazione e lo stato del gruppo

Dopo che la persona ha terminato il flusso nel browser, interroga entrambe le risorse:

curl -sS "https://aihubmix.com/ai/v1/verification-sessions/$SESSION_ID" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

curl -sS "https://aihubmix.com/ai/v1/asset-groups/$GROUP_ID" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

Continua solo quando la sessione di verifica è verified e il gruppo di risorse è active. Una pagina di errore del browser non determina il risultato finale; utilizza lo stato dell'API.

Passo 5: Aggiungi il ritratto

Invia l'URL diretto dell'immagine:

curl -sS -X POST \
  "https://aihubmix.com/ai/v1/asset-groups/$GROUP_ID/assets" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: portrait-001" \
  -d '{
    "url":"https://cdn.example.com/portrait.jpg",
    "asset_type":"image",
    "client_reference_id":"portrait-001"
  }'

Salva l'ID della risorsa restituito e interroga:

ASSET_ID="ast_your_asset_id"
curl -sS "https://aihubmix.com/ai/v1/assets/$ASSET_ID" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

Utilizza la risorsa solo quando il suo stato è active. creating e processing significano che non è ancora pronta.

Passo 6: Genera un video Seedance 2.5

La risorsa umana reale appartiene a input_references[].url. Non dovrebbe essere incollata nel testo del prompt:

curl -sS -X POST "https://aihubmix.com/ai/v1/videos" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\":\"doubao-seedance-2-5-260628\",
    \"prompt\":\"Un vlog verticale realistico. La persona sorride, saluta e dice in giapponese: やっほー！今日も笑顔でね！ Mantieni il volto coerente, sincronizza il movimento delle labbra, usa un movimento naturale delle mani e non aggiungere sottotitoli.\",
    \"duration\":5,
    \"resolution\":\"720p\",
    \"aspect_ratio\":\"3:4\",
    \"generate_audio\":true,
    \"input_references\":[{\"type\":\"image_url\",\"url\":\"asset://$ASSET_ID\"}]
  }"

La risposta restituisce un ID attività video. Interroga GET /ai/v1/videos/{id} fino a quando l'attività è completed, quindi scarica prontamente l'output perché gli URL video sono temporanei.

Seedance 2.5 e Seedance 2.0

Seedance 2.5 utilizza l'endpoint nativo /ai/v1/videos descritto sopra. Le integrazioni più vecchie possono utilizzare Seedance 2.0 con il protocollo compatibile /v1/videos e una struttura di contenuto diversa.

Non mescolare i due formati di richiesta. Prima dell'uso in produzione, controlla lo schema del modello live per le durate, le risoluzioni, i tipi di riferimento, il comportamento audio e i percorsi degli endpoint supportati.

Migliori pratiche per i prompt

Descrivi l'ambiente, l'azione, il tempo, il movimento della telecamera, la voce e i vincoli. Un buon prompt potrebbe specificare un kimono, petali di ciliegio che cadono, un saluto gentile, dialoghi giapponesi, movimento delle labbra sincronizzato, movimento naturale dei capelli e nessun sottotitolo.

Cinque secondi funzionano bene per un breve saluto. Se il video include diverse azioni o una lunga frase, utilizza una durata più lunga o accorcia il copione in modo che la performance non sembri affrettata.

Usa un riferimento identitario per un semplice test. Aggiungi riferimenti aggiuntivi solo quando lo schema del modello li supporta e ogni risorsa appartiene allo stesso gruppo di risorse.

Problemi comuni

Il gruppo non è attivo: attendi che la sessione di verifica diventi verified e il gruppo diventi active.
La risorsa è in elaborazione: interroga l'ID della risorsa originale; non creare duplicati con un nuovo ID.
L'URL dell'immagine non funziona: utilizza un URL di file HTTPS pubblico, non un percorso locale, una pagina di login o una pagina di condivisione.
Il video rifiuta la risorsa: conferma che la risorsa sia active, appartenga allo stesso account e utilizzi il tipo di media corretto.
Il Playground non mostra asset://: Il caricamento di immagini nel Playground e la registrazione di risorse umane reali sono flussi di lavoro separati. Utilizza il campo di riferimento API per le risorse registrate.

Lista di controllo finale

Chiave API configurata in modo sicuro.
Gruppo di risorse creato.
Autorizzazione della persona completata.
Lo stato del gruppo è active.
Lo stato della risorsa ritratto è active.
La richiesta video utilizza asset://<asset_id>.
Il compito video è interrogato fino a completed.

Le risorse umane reali di AIHubMix offrono agli sviluppatori un modo pratico per costruire esperienze video basate sul consenso e coerenti con l'identità con Seedance. Inizia con un ritratto approvato e un breve clip di prova, quindi espandi lo stesso flusso di lavoro in strumenti per creatori, contenuti di marca e applicazioni di produzione.