AI-video wordt veel nuttiger wanneer de persoon in beeld van scène tot scène herkenbaar blijft. AIHubMix real-human assets bieden een op toestemming gebaseerde manier om een goedgekeurd gezicht te gebruiken in Seedance-videogeneratie, waarbij autorisatie, asset-verwerking en generatie als afzonderlijke, verifieerbare stappen verlopen.
Deze gids legt uit wat real-human video is, hoe de AIHubMix-workflow werkt, waarom die nuttig is en hoe je een Seedance 2.5-video maakt van een echt gezicht. Ook wordt uitgelegd wat het verschil is tussen de native Seedance 2.5 API en compatibele Seedance 2.0-integraties.
Wat is real-human video?
Real-human video is AI-gegenereerde video die een geautoriseerde persoon gebruikt als identiteitsreferentie. Het model kan de omgeving, kleding, actie, cameravoering, stem of taal veranderen en tegelijk het herkenbare uiterlijk van de persoon behouden.
Dit verschilt van gewone text-to-video-generatie. Een tekstprompt beschrijft wat er moet gebeuren, maar identificeert niet betrouwbaar een specifiek echt persoon. Een real-human asset geeft het model een goedgekeurde visuele referentie die voor meerdere video's opnieuw kan worden gebruikt.
Typische toepassingen zijn creator-avatars, virtuele presentatoren, productuitleg, gelokaliseerde campagnes, trainingsvideo's, merkpersonages en korte social-media-content.
Hoe de AIHubMix-workflow werkt
De workflow bestaat uit vijf hoofdstappen:
- Maak een asset-groep voor één persoon aan.
- Vraag de persoon op de afbeelding om de autorisatieprocedure te doorlopen.
- Voeg een portret toe en wacht tot de asset actief is.
- Verwijs naar het actieve asset met een
asset://-URI. - Dien een Seedance-videotaak in en controleer die totdat deze is voltooid.
De scheiding is bewust gekozen. Autorisatie gebeurt vóór generatie, de gereedheid van de asset kan onafhankelijk worden gecontroleerd en elke belangrijke stap toont een status die je applicatie kan monitoren.
Waarom AIHubMix gebruiken?
Eén API voor de complete workflow
AIHubMix biedt endpoints voor asset-groepen, verificatiesessies, human assets en asynchrone videogeneratie. Hetzelfde account en dezelfde API-sleutel kunnen de volledige pipeline beheren.
Expliciete autorisatie
De persoon op het portret voltooit de autorisatiepagina. Dit zorgt voor een duidelijke toestemmingsstap voordat de afbeelding als herbruikbare real-human referentie wordt gebruikt.
Herbruikbare identiteitsassets
Zodra een afbeelding actief is, kunnen applicaties de asset-ID hergebruiken voor meerdere videoverzoeken, in plaats van de originele afbeelding elke keer opnieuw te uploaden.
Generatie klaar voor Seedance
Het native Seedance 2.5-endpoint ondersteunt tekst-, afbeelding-, video- en audioreferenties, plus opties voor duur, resolutie, beeldverhouding en audiogeneratie.
Waarneembare, productievriendelijke statussen
Je applicatie kan wachten op verified, active en completed, in plaats van te raden of een bewerking is afgerond. Dit maakt herhalingspogingen en foutafhandeling eenvoudiger te implementeren.
Stapsgewijze handleiding
Stap 1: Maak een API-sleutel en portret klaar
Maak een API-sleutel aan in de AIHubMix Console. Houd deze privé. Stel deze in Terminal in als omgevingsvariabele:
export AIHUBMIX_API_KEY="your_api_key"
Bereid een directe HTTPS-URL van de afbeelding voor. De URL moet het afbeeldingsbestand teruggeven zonder login of aangepaste headers en moet beschikbaar blijven terwijl AIHubMix deze verwerkt.
Aanbevolen eisen voor de afbeelding:
- JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC of HEIF
- Kleiner dan 30 MB
- Breedte en hoogte groter dan 300 pixels en kleiner dan 6000 pixels
- Beeldverhouding groter dan 0,4 en kleiner dan 2,5
- Een duidelijk portret van dezelfde persoon die de autorisatie voltooit
Stap 2: Maak een real-human asset-groep aan
Voer dit commando 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":"My real-human asset"}'
Sla de teruggegeven id op, 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 groep-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"
Het antwoord bevat een tijdelijke verification_url. Open die URL in een browser en vraag de persoon op het portret het doel te bekijken en de autorisatieprocedure te voltooien.
De URL is gevoelig en tijdelijk. Publiceer deze niet, commit deze niet naar een repository en neem deze niet op in screenshots.
Stap 4: Verifieer autorisatie en groepsstatus
Nadat de persoon de browserprocedure heeft afgerond, vraag je beide resources 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 alleen verder wanneer de verificatiesessie verified is en de asset-groep active is. Een browserfoutpagina bepaalt het eindresultaat niet; gebruik de API-status.
Stap 5: Voeg het portret toe
Dien de directe URL van de afbeelding 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"
}'
Sla de teruggegeven asset-ID op en controleer deze met polling:
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. Plak deze niet in de prompttekst:
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\":\"A realistic vertical vlog. The person smiles, waves, and says in Japanese: やっほー！今日も笑顔でね！ Keep the face consistent, synchronize lip movement, use natural hand motion, and add no subtitles.\",
\"duration\":5,
\"resolution\":\"720p\",
\"aspect_ratio\":\"3:4\",
\"generate_audio\":true,
\"input_references\":[{\"type\":\"image_url\",\"url\":\"asset://$ASSET_ID\"}]
}"
Het antwoord geeft een video-taak-ID terug. Controleer GET /ai/v1/videos/{id} totdat de taak completed is, en download daarna de output snel, omdat video-URL's tijdelijk zijn.
Seedance 2.5 en Seedance 2.0
Seedance 2.5 gebruikt het native endpoint /ai/v1/videos dat hierboven is beschreven. Oudere integraties gebruiken mogelijk Seedance 2.0 met het compatibele /v1/videos-protocol en een andere contentstructuur.
Meng de twee requestformaten niet. Controleer voor productiegebruik het actuele modelschema op ondersteunde duren, resoluties, referentietypen, audiogedrag en endpointpaden.
Best practices voor prompts
Beschrijf de omgeving, actie, timing, cameravoering, stem en beperkingen. Een sterke prompt kan een kimono, vallende kersenbloesems, een zachte golf, Japanse dialoog, gesynchroniseerde lipbewegingen, natuurlijke haarbeweging en geen ondertitels specificeren.
Vijf seconden werkt goed voor een korte begroeting. Als de video meerdere acties of een lange zin bevat, gebruik dan een langere duur of kort het script in, zodat de uitvoering niet gehaast aanvoelt.
Gebruik één identiteitsreferentie voor een eenvoudige test. Voeg extra referenties alleen toe wanneer het modelschema dit ondersteunt en elke asset tot dezelfde asset-groep behoort.
Veelvoorkomende problemen
- De groep is niet actief: wacht tot de verificatiesessie
verifiedis en de groepactiveis. - De asset wordt verwerkt: controleer de oorspronkelijke asset-ID met polling; maak geen duplicaten met een nieuwe ID.
- De afbeeldings-URL werkt niet: gebruik een publieke HTTPS-bestands-URL, geen lokaal pad, loginpagina of deelpagina.
- De video weigert de asset: controleer of de asset
activeis, bij hetzelfde account hoort en het juiste mediatype gebruikt. - Playground toont
asset://niet: uploaden van afbeeldingen in Playground en registratie van real-human assets zijn aparte workflows. Gebruik voor geregistreerde assets het referentieveld van de API.
Eindcontrolelijst
- API-sleutel veilig ingesteld.
- Asset-groep aangemaakt.
- Autorisatie van de persoon voltooid.
- Groepsstatus is
active. - Status van de portret-asset is
active. - Videoverzoek gebruikt
asset://<asset_id>. - Videotaak wordt gecontroleerd tot
completed.
AIHubMix real-human assets geven ontwikkelaars een praktische manier om op toestemming gebaseerde, identiteitsconsistente videoervaringen met Seedance te bouwen. Begin met één goedgekeurd portret en een korte testclip, en breid daarna dezelfde workflow uit naar creator-tools, merkcontent en productietoepassingen.
