Foto til MetaHuman · API og AI-agenter
Et hoved er et API-kald.
Send fotos af en person fra din kode, eller bed din AI-agent om det. Cirka 4 minutter senere har du et færdigt MetaHuman-hoved: personens egen hud i 4K, anbefalede grooms (MetaHuman-hår), en tilpasset hals og 52 ARKit-blendshapes, i seks formater. 1.500 kreditter pr. hoved til 0,01 US$ pr. kredit, og et mislykket hoved koster ingenting.
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.Indsæt i Claude Code, Codex, Cursor, Gemini CLI eller OpenClaw. Du godkender en kode; ingen nøgle at kopiere. Lad prompten være på engelsk: din agent skal have webadressen præcis, som den står. Bagefter kan du tale med den på dit eget sprog.
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/faceninjaReturnerer hovedets id med det samme. Vi kalder din webhook, når det er færdigt.
- 0,01 US$ pr. kredit, betal efter forbrug
- 1.500 kreditter pr. hoved, alle filer inkluderet
- Intet abonnement
- Mislykkede hoveder refunderes




- 1MetaHuman-topologiSamme vertex-rækkefølge og UV'er på hvert hoved.
- 2Øjne og tænderSidder på plads; irisfarve fra fotoet.
- 3Hud i 4KBasisfarve, normal, cavity, specular/roughness.
- 452 ARKit-blendshapesLavet til dette ansigt, tongueOut inkluderet.
- 5En hals, der passerHals og trapezius følger personen.
Ind: ét foto. Ud: dette hoved, uretoucheret. En syntetisk person.
Træk, eller brug ← →- Input
- 1 fotoop til 15 af én person
- Topologi
- MetaHumanhoved, hals, skuldre
- Udtryk
- 52 ARKitlavet til ansigtet
- Hudmaps
- 4 × 4Kfarve, normal, cavity, spec/rough
- Køretid
- cirka 4 minpr. hoved, uanset rute
- Pris
- 0,01 US$pr. kredit · 1.500 pr. hoved
Hvert kald giver et færdigt hoved, ikke et skaldet mesh.
Automatisering kan kun betale sig, hvis ingen skal færdiggøre resultatet i hånden. Det her er, hvad hvert hoved indeholder, fra API'et, en agent eller webappen, uden ekstra betaling.
- Ansigtet i MetaHuman-topologi. Hoved, hals og skuldre, øjne og tænder. Samme vertex-rækkefølge og UV'er på hvert hoved, så ét rig passer til dem alle.
- Personens egen hud. 4K-maps for basisfarve, normal, cavity og specular/roughness, i MetaHumans UV-layout.
- Hår, øjenbryn, øjenvipper og skæg, med navn. Anbefalede MetaHuman-grooms med farveværdier i
groom.json, som dine værktøjer kan læse. - En hals, der passer. Hals og trapezius følger personens egne proportioner.
- 52 ARKit-blendshapes. Lavet til dette ansigt,
tongueOutinkluderet, klar til ansigtssporing og læbesynkronisering. - Seks formater. GLB, FBX, OBJ, STL, PLY og en MetaHuman ZIP. Hent hvilke som helst af dem, så ofte du vil.
Fire svære fotos
Hårdt lys, dybe rynker


Den orange farvetone er væk fra huden; rynkerne bliver stående som relief.
En latter og briller


Latteren er ikke bagt ind i formen.
Fuldskæg, hoved drejet


Kæben er genskabt; skægget kommer tilbage som en groom.
Hår over ørerne


Ansigtet er hendes; ørenes form hentes ikke fra fotoet.
Ingen af disse personer findes. Vi har genereret fotos, så vi kunne teste uden nogens ansigt. Hovederne er præcis, som de kom ud.
Se eksemplerne.
Hvert hoved her er lavet af FaceNinja ud fra ét foto og vist præcis, som det kom ud. Flere eksempler er på vej, med flere slags ansigter, lys og hår.












Prøv udtrykkene på et hoved, API'et har lavet.
Det er den samme lette forhåndsvisning, som webappen viser for hvert hoved. Hver knap styrer hovedets egne ARKit-blendshapes. Slå hårvisningen til for at bedømme ligheden med hår.
Eksempelhoveder

Piletaster drejer hovedet. Plus og minus zoomer. Nul nulstiller visningen. Escape forlader viseren.
ARKit-aflæsning
Værdierne følger udtrykket. Træk i en skyder for at sætte én form.
Ét hoved eller fem hundrede, det samme kald.
Et hoved tager cirka 4 minutter, så FaceNinja er asynkront fra starten. Du sender, du får besked, du henter. Alt det, der gør en batch trygt at køre uden opsyn, ligger i API'et, og agent-skillen bruger det samme API.
Din agent kan gøre det.
- Opret en konto. Opret en konto med Google eller din e-mail, og køb kreditter.
- Indsæt én prompt i Claude Code, Codex, Cursor, Gemini CLI eller OpenClaw.
- Godkend koden som din agent viser dig på
faceninja.net/device.
Bed derefter om mere: »ét hoved pr. undermappe i ./cast«, »alle hoveder igen som FBX«, »skriv en webhook-pipeline til mig«. Skillen fortæller dig prisen og din saldo, før den bruger noget, og spørger, før den laver mere end 5 hoveder.
Din kode kan gøre det.
- Idempotensnøgler. Gentag en oprettelse med samme nøgle, og du får det samme hoved, aldrig en ekstra betaling.
- Signerede webhooks.
head.completedoghead.failed, signeret iFaceNinja-Signature. Eller en strøm af server-sent events, eller?waittil scripts. - Plads til batches. 30 oprettelser af hoveder og 600 forespørgsler i minuttet pr. konto.
- Fejl, du kan reagere på. Stabile koder som
no_faceognot_same_person, hver med et hint. - Refusion uden tickets. Kreditter reserveres ved oprettelsen og frigives af sig selv, hvis et hoved mislykkes.
- Links, ikke vedhæftninger. Hver fil kommer som et kortlivet signeret link. Gem hovedets id, og spørg igen, når du skal bruge det.
POST /v1/headsfotos af én person- hoved-id
head.completedsigneret webhook, når det er færdigtPOST /v1/heads/{id}/filesformat- kortlivet signeret link
Unreal-automatisering, som tilpasser ansigtet, sætter huden, tager grooms på og vælger en krop inde i Unreal Engine, er i tidlig adgang. Bed om den Tidlig adgang
Fire slags pipelines, én slags hoved.
Værktøjer og platforme
Føj »lav et hoved ud fra et foto« til dit produkt. Webhooks ind, signerede links ud, refusion uden supporttickets.
UdviklereSpilstudier
Spilleransigter eller en NPC-rollebesætning, alt på ét mesh, så ét rig og ét materiale passer til hvert hoved.
Hoveder til et spilFolk, der bruger agenter
Giv opgaven til Claude Code, Codex eller Cursor: en rollebesætning ud fra en mappe, FBX til hvert hoved, et pipeline-script.
Brug med AI-agenterTekniske artister
Åbn MetaHuman Creator med tilpasningen, huden og grooms allerede besluttet.
Hovedets indhold0,01 US$ pr. kredit, uanset hvordan du bestiller.
API'et, din agent og webappen trækker på én saldo til én pris. Køb kreditter i en pakke eller i et vilkårligt beløb, uden abonnement. Et hoved koster 1.500 kreditter, og hvis det mislykkes, kommer kreditterne tilbage af sig selv. Moms eller salgsafgift lægges til ved betalingen, hvor det gælder.
Ét hoved, i browseren.
Du behøver ingen agent og ingen API-nøgle. Log ind med Google, læg ét til 15 fotos af én person ind, og hent hovedet på cirka 4 minutter. Webappen viser 3D-forhåndsvisningen med udtryk og hår, før du henter det.
Før du automatiserer.
- 01Skal jeg skrive kode?
- Nej. Indsæt én prompt i en AI-agent som Claude Code eller Cursor, eller brug webappen i din browser. Brug med AI-agenter
- 02Hvor lang tid tager et hoved?
- Cirka 4 minutter fra upload. Når mange hoveder venter, står dit i kø, og API'et melder dets plads i køen.
- 03Hvor mange fotos skal jeg bruge?
- Ét skarpt foto er nok. Op til 15 fotos af samme person hjælper, især en profil og en halvprofil. Fototips
- 04Hvad sker der, hvis et hoved mislykkes?
- Dets 1.500 kreditter går tilbage til din saldo af sig selv, og
error.codefortæller hvorfor, for eksempelno_face. - 05Er håret en del af hovedet?
- Nej. I MetaHuman er hår, øjenbryn og skæg grooms. Vi anbefaler de rigtige med deres farver, som data, dine værktøjer kan læse.
- 06Hvis fotos må jeg bruge?
- Dine egne, eller fotos af en voksen, der har sagt ja til at få lavet et 3D-hoved af sig. Vi laver ikke hoveder af børn eller ud fra fotos fundet på nettet. Acceptabel brug EN
- 07Hvad sker der med mine fotos?
- De slettes efter 30 dage, og du kan slette et hoved og dets fotos før. Privatlivspolitik EN
Dit første hoved er én prompt væk.
Opret en konto, køb kreditter, indsæt prompten og godkend koden.