Hoe een Echt Gezicht te Gebruiken in Seedance 2.5 met AIHubMix Real-Human Assets

AI-video wordt veel nuttiger wanneer de persoon op het scherm herkenbaar blijft van de ene scène naar de volgende. AIHubMix real-human assets bieden een op toestemming gebaseerde manier om een goedgekeurd gezicht te gebruiken in Seedance video-generatie, terwijl autorisatie, assetverwerking en generatie als afzonderlijke, verifieerbare stappen worden gehouden.

Deze gids legt uit wat real-human video is, hoe de AIHubMix workflow werkt, waarom het nuttig is en hoe je een Seedance 2.5 video kunt maken van een echt gezicht. Het legt ook het verschil uit tussen de native Seedance 2.5 API en compatibele Seedance 2.0 integraties.

Wat Is Real-Human Video?

Real-human video is AI-gegeneerde video die een geautoriseerd persoon gebruikt als identiteitsreferentie. Het model kan de setting, kleding, actie, camerabeweging, stem of taal veranderen terwijl het herkenbare uiterlijk van de persoon behouden blijft.

Dit is anders dan gewone tekst-naar-video generatie. Een tekstprompt beschrijft wat er moet gebeuren, maar identificeert niet betrouwbaar een specifieke echte persoon. Een real-human asset geeft het model een goedgekeurde visuele referentie die kan worden hergebruikt in meerdere video's.

Typische toepassingen zijn onder andere creator avatars, virtuele presentatoren, productuitlegvideo's, gelokaliseerde campagnes, trainingsvideo's, merkpersonages en korte sociale content.

Hoe de AIHubMix Workflow Werkt

De workflow heeft vijf hoofd fasen:

1. Maak een assetgroep voor één persoon.
2. Vraag de persoon op de afbeelding om de autorisatieflow te voltooien.
3. Voeg een portret toe en wacht tot de asset actief is.
4. Verwijs naar de actieve asset met een asset:// URI.
5. Dien een Seedance video-taak in en poll deze tot voltooiing.

De scheiding is opzettelijk. Autorisatie gebeurt vóór generatie, de gereedheid van de asset kan onafhankelijk worden gecontroleerd, en elke belangrijke fase toont een status die jouw applicatie kan volgen.

Waarom AIHubMix Gebruiken?

Één API voor de volledige workflow

AIHubMix biedt eindpunten voor assetgroepen, verificatiesessies, menselijke assets en asynchrone video-generatie. Met hetzelfde account en API-sleutel kan de volledige pipeline worden beheerd.

Expliciete autorisatie

De persoon op het portret voltooit de autorisatiepagina. Dit creëert een duidelijke toestemmingsstap voordat de afbeelding wordt gebruikt als een herbruikbare real-human referentie.

Herbruikbare identiteitsassets

Nadat een afbeelding actief is geworden, kunnen applicaties de asset-ID hergebruiken in meerdere video-aanvragen in plaats van de originele afbeelding elke keer opnieuw te uploaden.

Seedance-klaar generatie

Het native Seedance 2.5 eindpunt ondersteunt tekst-, afbeelding-, video- en audioreferenties, plus controles voor duur, resolutie, beeldverhouding en audiogeneratie.

Observeerbare, productie-vriendelijke staten

Jouw applicatie kan wachten op verified, active en completed in plaats van te gokken of een operatie is voltooid. Dit maakt het gemakkelijker om herhalingen en foutafhandeling te implementeren.

Stapsgewijze Handleiding

Stap 1: Bereid een API-sleutel en portret voor

Maak een API-sleutel aan in de AIHubMix Console. Houd deze privé. Stel deze in Terminal in als een omgevingsvariabele:

export AIHUBMIX_API_KEY="your_api_key"

Bereid een directe HTTPS afbeeldings-URL voor. De URL moet het afbeeldingsbestand retourneren zonder inloggen of aangepaste headers en moet beschikbaar blijven terwijl AIHubMix deze verwerkt.

Aangeraden afbeeldingsvereisten:

• JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC of HEIF
• Minder dan 30 MB
• Breedte en hoogte groter dan 300 pixels en minder dan 6000 pixels
• Beeldverhouding groter dan 0.4 en minder dan 2.5
• Een duidelijk portret van dezelfde persoon die de autorisatie voltooit

Stap 2: Maak een real-human assetgroep

Voer deze opdracht uit 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":"Mijn real-human asset"}'

Bewaar de teruggegeven id, die eruitziet als ag_...:

GROUP_ID="ag_your_group_id"

Een nieuwe groep begint normaal gesproken met pending_auth.

Stap 3: Maak een autorisatiesessie aan

Gebruik de groeps-ID om een verificatiesessie aan te vragen:

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

De reactie bevat een tijdelijke verification_url. Open die URL in een browser en vraag de persoon op het portret om het doel te bekijken en de autorisatieflow te voltooien.

De URL is gevoelig en tijdelijk. Publiceer deze niet, commit deze niet in een repository, of voeg deze niet toe aan screenshots.

Stap 4: Verifieer autorisatie en groepsstatus

Nadat de persoon de browserflow heeft voltooid, vraag beide bronnen op:

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"

Ga verder alleen wanneer de verificatiesessie verified is en de assetgroep active is. Een foutpagina in de browser bepaalt het eindresultaat niet; gebruik de API-status.

Stap 5: Voeg het portret toe

Dien de directe afbeeldings-URL in:

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"
  }'

Bewaar de teruggegeven asset-ID en poll deze:

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

Gebruik de asset alleen wanneer de status active is. creating en processing betekenen dat deze nog niet klaar is.

Stap 6: Genereer een Seedance 2.5 video

De real-human asset hoort in input_references[].url. Het mag niet in de prompttekst worden geplakt:

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\":\"Een realistische verticale vlog. De persoon glimlacht, zwaait en zegt in het Japans: やっほー！今日も笑顔でね！ Houd het gezicht consistent, synchroniseer de lipbeweging, gebruik natuurlijke handbewegingen en voeg geen ondertitels toe.\",
    \"duration\":5,
    \"resolution\":\"720p\",
    \"aspect_ratio\":\"3:4\",
    \"generate_audio\":true,
    \"input_references\":[{\"type\":\"image_url\",\"url\":\"asset://$ASSET_ID\"}]
  }"

De reactie retourneert een video-taak-ID. Poll GET /ai/v1/videos/{id} totdat de taak completed is, download dan snel de output omdat video-URL's tijdelijk zijn.

Seedance 2.5 en Seedance 2.0

Seedance 2.5 gebruikt het native /ai/v1/videos eindpunt dat hierboven is beschreven. Oudere integraties kunnen Seedance 2.0 gebruiken met het compatibele /v1/videos protocol en een andere contentstructuur.

Mix de twee aanvraagformaten niet. Controleer voor productiegebruik het live model schema voor ondersteunde duur, resoluties, referentietypes, audio gedrag en eindpuntpaden.

Best Practices voor Prompts

Beschrijf de omgeving, actie, timing, camerabeweging, stem en beperkingen. Een sterke prompt kan een kimono specificeren, vallende kersenbloesems, een zachte golf, Japanse dialoog, gesynchroniseerde lipbeweging, natuurlijke haarbeweging en geen ondertitels.

Vijf seconden werkt goed voor een korte begroeting. Als de video verschillende acties of een lange zin bevat, gebruik dan een langere duur of verkort het script zodat de uitvoering niet gehaast aanvoelt.

Gebruik één identiteitsreferentie voor een eenvoudige test. Voeg extra referenties alleen toe wanneer het model schema deze ondersteunt en elke asset tot dezelfde assetgroep behoort.

Veelvoorkomende Problemen

• De groep is niet actief: wacht tot de verificatiesessie verified is en de groep active is.
• De asset is aan het verwerken: poll de originele asset-ID; maak geen duplicaten met een nieuwe ID.
• De afbeeldings-URL faalt: gebruik een openbare HTTPS-bestand-URL, geen lokale pad, inlogpagina of deelpagina.
• De video weigert de asset: bevestig dat de asset active is, tot hetzelfde account behoort en het juiste mediatype gebruikt.
• Playground toont geen asset://: Playground afbeeldingsupload en registratie van real-human assets zijn afzonderlijke workflows. Gebruik het API-referentieveld voor geregistreerde assets.

Eindchecklijst

1. API-sleutel veilig geconfigureerd.
2. Assetgroep aangemaakt.
3. Persoon autorisatie voltooid.
4. Groepsstatus is active.
5. Portret assetstatus is active.
6. Video-aanvraag gebruikt asset://<asset_id>.
7. Video-taak is gepolled tot completed.

AIHubMix real-human assets bieden ontwikkelaars een praktische manier om toestemming-gebaseerde, identiteits-consistente video-ervaringen met Seedance te bouwen. Begin met één goedgekeurd portret en een korte testclip, en breid dezelfde workflow uit naar creator tools, merkcontent en productieapplicaties.