Foto naar MetaHuman · API en AI-agents
Een hoofd is een API-call.
Stuur foto's van een persoon vanuit je code, of vraag je AI-agent dat te doen. Ongeveer 4 minuten later heb je een afgewerkt MetaHuman-hoofd: de eigen huid van de persoon in 4K, aanbevelingen voor grooms (MetaHuman-haar), een passende nek en 52 ARKit-blendshapes, in zes formaten. 1.500 credits per hoofd tegen US$ 0,01 per credit, en een mislukt hoofd kost niets.
Read https://faceninja.net/skill/SKILL.md and install the FaceNinja skill it describes. Then sign me in with it (it will show me a code to approve) and make a MetaHuman head from ./photo.jpg. Save the GLB and the MetaHuman ZIP in ./faceninja-out.Plak in Claude Code, Codex, Cursor, Gemini CLI of OpenClaw. Jij keurt een code goed; geen key om te kopiëren. Laat deze prompt in het Engels: je agent heeft het webadres precies zo nodig als het er staat. Daarna kun je er in je eigen taal mee praten.
curl https://api.faceninja.net/v1/heads \
-H "Authorization: Bearer $FACENINJA_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-F photos=@photo.jpg -F webhook_url=https://you.example/hooks/faceninjaGeeft meteen de id van het hoofd terug. Als het klaar is, roepen wij je webhook aan.
- US$ 0,01 per credit, betaal wat je gebruikt
- 1.500 credits per hoofd, elk bestand inbegrepen
- Geen abonnement
- Mislukte hoofden worden terugbetaald
- 1MetaHuman-topologieOp elk hoofd dezelfde vertexvolgorde en UV's.
- 2Ogen en tandenIn hun kassen; iriskleur uit de foto.
- 3Huid in 4KBasiskleur, normal, cavity, specular/roughness.
- 452 ARKit-blendshapesGemaakt voor dit gezicht, tongueOut inbegrepen.
- 5Een nek die pastNek en trapezius volgen de persoon.
In: één foto. Uit: dit hoofd, onbewerkt. Een synthetische mens.
Sleep of gebruik ← →- Invoer
- 1 fototot 15 van één persoon
- Topologie
- MetaHumanhoofd, nek, schouders
- Expressies
- 52 ARKitgemaakt voor het gezicht
- Huidmaps
- 4 × 4Kkleur, normal, cavity, spec/rough
- Doorlooptijd
- ongeveer 4 minper hoofd, via elke route
- Tarief
- US$ 0,01per credit · 1.500 per hoofd
Elke call levert een afgewerkt hoofd op, geen kale mesh.
Automatiseren loont alleen als niemand het resultaat nog met de hand hoeft af te maken. Dit zit in elk hoofd, via de API, een agent of de webapp, zonder extra kosten.
- Het gezicht, in MetaHuman-topologie. Hoofd, nek en schouders, ogen en tanden. Op elk hoofd dezelfde vertexvolgorde en UV's, zodat één rig op allemaal past.
- De eigen huid van de persoon. Maps voor basiskleur, normal, cavity en specular/roughness in 4K, in de UV-indeling van MetaHuman.
- Haar, wenkbrauwen, wimpers en baard, bij naam genoemd. Aanbevelingen voor MetaHuman-grooms met kleurwaarden, als
groom.jsondie je tools kunnen lezen. - Een nek die past. Nek en trapezius volgen de eigen proporties van de persoon.
- 52 ARKit-blendshapes. Gemaakt voor dit gezicht,
tongueOutinbegrepen, klaar voor face tracking en lipsync. - Zes formaten. GLB, FBX, OBJ, STL, PLY en een MetaHuman ZIP. Vraag het formaat dat je nodig hebt, zo vaak als je wilt.
Vier lastige foto's
Fel licht, diepe rimpels
De oranje kleurzweem is uit de huid verdwenen; de rimpels blijven als reliëf.
Een lach en een bril
De lach zit niet in de vorm ingebakken.
Volle baard, gedraaid
De kaak is hersteld; de baard komt terug als groom.
Haar over de oren
Het gezicht is dat van haar; de vorm van de oren komt niet uit de foto.
Geen van deze mensen bestaat. We hebben de foto's gegenereerd om te kunnen testen zonder iemands gezicht. De hoofden zijn precies wat eruit kwam.
Bekijk de voorbeelden.
Elk hoofd hier is door FaceNinja gemaakt van één foto en wordt getoond precies zoals het eruit kwam. Er komen meer voorbeelden, met meer soorten gezichten, licht en haar.
Probeer de expressies uit op een hoofd dat de API heeft gemaakt.
Dit is dezelfde lichte preview die de webapp bij elk hoofd toont. Elke knop stuurt de eigen ARKit-blendshapes van het hoofd aan. Zet de haarpreview aan om de gelijkenis te beoordelen met het haar erbij.
Voorbeeldhoofden
Pijltjestoetsen draaien het hoofd. Plus en min zoomen. Nul herstelt de weergave. Escape verlaat de viewer.
ARKit-waarden
Waarden volgen de expressie. Sleep een schuifregelaar voor één shape.
Eén hoofd of vijfhonderd, dezelfde call.
Een hoofd duurt ongeveer 4 minuten, dus FaceNinja is vanaf het begin asynchroon. Je stuurt, je krijgt bericht, je haalt op. Alles wat een batch veilig onbeheerd laat draaien zit in de API, en de skill voor agents gebruikt dezelfde API.
Je agent kan het.
- Maak een account. Maak een account met Google of je e-mailadres en koop credits.
- Plak één prompt in Claude Code, Codex, Cursor, Gemini CLI of OpenClaw.
- Keur de code goed die je agent je toont op
faceninja.net/device.
Vraag daarna om meer: “één hoofd per submap van ./cast”, “elk hoofd nog eens als FBX”, “schrijf me een webhook-pipeline”. De skill noemt de kosten en je saldo voordat hij iets uitgeeft, en vraagt het eerst bij meer dan 5 hoofden.
Je code kan het.
- Idempotency-keys. Herhaal een create met dezelfde key en je krijgt hetzelfde hoofd, nooit een tweede afschrijving.
- Ondertekende webhooks.
head.completedenhead.failed, ondertekend inFaceNinja-Signature. Of een server-sent-eventstream, of?waitvoor scripts. - Ruimte voor batches. 30 hoofden aanmaken en 600 requests per minuut per account.
- Fouten waar je code op kan vertakken. Stabiele codes zoals
no_faceennot_same_person, elk met een hint. - Terugbetalingen zonder tickets. Credits worden bij het aanmaken vastgehouden en komen vanzelf vrij als een hoofd mislukt.
- Links, geen bijlagen. Elk bestand komt als een kortlevende ondertekende link. Bewaar de id van het hoofd en vraag opnieuw op wanneer je het nodig hebt.
POST /v1/headsfoto's van één persoon- id van het hoofd
head.completedondertekende webhook als het klaar isPOST /v1/heads/{id}/filesformaat- kortlevende ondertekende link
Unreal-automatisering, die in Unreal Engine het gezicht conformeert, de huid instelt, de grooms opzet en een lichaam kiest, is beschikbaar in vroege toegang. Vraag ernaar Vroege toegang
Vier soorten pipelines, één soort hoofd.
Tools en platforms
Voeg “maak een hoofd van een foto” toe aan je product. Webhooks erin, ondertekende links eruit, terugbetalingen zonder supporttickets.
Developers
Gamestudio's
Spelergezichten of een cast van NPC's, allemaal op één mesh, zodat één rig en één materiaal op elk hoofd passen.
Hoofden voor een game
Wie met agents werkt
Geef de klus aan Claude Code, Codex of Cursor: een cast uit een map, FBX voor elk hoofd, een pipelinescript.
Gebruik met AI-agents
Technical artists
Open MetaHuman Creator met de conform, de huid en de grooms al bepaald.
Wat zit er in een hoofdUS$ 0,01 per credit, hoe je een hoofd ook aanvraagt.
De API, je agent en de webapp putten uit één saldo tegen één prijs. Koop credits in een pakket of voor elk gewenst bedrag, zonder abonnement. Een hoofd kost 1.500 credits, en als het mislukt, komen die credits vanzelf terug. Btw of omzetbelasting wordt bij het afrekenen toegevoegd, waar die van toepassing is.
Eén hoofd, in de browser.
Je hebt geen agent of API-key nodig. Log in met Google, sleep één tot 15 foto's van één persoon erin en download het hoofd na ongeveer 4 minuten. De webapp toont vóór het downloaden de 3D-preview met expressies en haar.
Voordat je automatiseert.
- 01Moet ik code schrijven?
- Nee. Plak één prompt in een AI-agent zoals Claude Code of Cursor, of gebruik de webapp in je browser. Gebruik met AI-agents
- 02Hoe lang duurt een hoofd?
- Ongeveer 4 minuten vanaf het uploaden. Als er veel hoofden wachten, komt het jouwe in de wachtrij en meldt de API zijn plek in de rij.
- 03Hoeveel foto's heb ik nodig?
- Eén scherpe foto is genoeg. Tot 15 foto's van dezelfde persoon helpen, vooral een profielfoto en een driekwartsaanzicht. Fototips
- 04Wat gebeurt er als een hoofd mislukt?
- De 1.500 credits komen vanzelf terug op je saldo, en
error.codezegt waarom, bijvoorbeeldno_face. - 05Zit het haar in het hoofd?
- Nee. In MetaHuman zijn haar, wenkbrauwen en baarden grooms. Wij raden de juiste aan, met hun kleuren, als data die je tools kunnen lezen.
- 06Wiens foto's mag ik gebruiken?
- Je eigen foto's, of foto's van een volwassene die ermee heeft ingestemd dat er een 3D-hoofd van wordt gemaakt. We maken geen hoofden van kinderen en ook niet van foto's die online zijn gevonden. Toegestaan gebruik EN
- 07Wat gebeurt er met mijn foto's?
- Ze worden na 30 dagen verwijderd, en je kunt een hoofd en de bijbehorende foto's eerder verwijderen. Privacybeleid EN
Nog één prompt tot je eerste hoofd.
Maak een account, koop credits, plak de prompt en keur de code goed.