Din fotografie în MetaHuman · API și agenți AI
Un cap este un apel API.
Trimiteți fotografii ale unei persoane din cod sau cereți agentului AI să o facă. După aproximativ 4 minute primiți un cap MetaHuman finalizat: pielea proprie a persoanei în 4K, recomandări de groom (păr MetaHuman), un gât adaptat și 52 de forme ARKit, în șase formate. 1.500 de credite per cap, la 0,01 USD per credit, iar un cap eșuat nu costă nimic.
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.Lipiți-l în Claude Code, Codex, Cursor, Gemini CLI sau OpenClaw. Aprobați un cod; nu aveți nicio cheie de copiat. Lăsați acest prompt în engleză: agentul are nevoie de adresa web exact așa cum este scrisă. Apoi îi puteți vorbi în limba dumneavoastră.
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/faceninjaReturnează imediat ID-ul capului. Vă apelăm webhook-ul când este gata.
- 0,01 USD per credit, plătiți cât folosiți
- 1.500 de credite per cap, toate fișierele incluse
- Fără abonament
- Capetele eșuate sunt rambursate




- 1Topologie MetaHumanAceeași ordine a vertex-urilor și aceleași UV-uri pe fiecare cap.
- 2Ochi și dințiLa locul lor, în orbite; culoarea irisului din fotografie.
- 3Piele în 4KCuloare de bază, normal, cavity, specular/roughness.
- 452 de forme ARKitCreate pentru această față, tongueOut inclus.
- 5Un gât care se potriveșteGâtul și trapezul se potrivesc persoanei.
Intrare: o fotografie. Ieșire: acest cap, neretușat. O persoană sintetică.
Trageți sau folosiți ← →- Intrare
- 1 fotografiepână la 15 ale unei persoane
- Topologie
- MetaHumancap, gât, umeri
- Expresii
- 52 ARKitcreate pentru față
- Hărți piele
- 4 × 4Kculoare, normal, cavity, spec/rough
- Durată
- circa 4 minper cap, pe orice cale
- Tarif
- 0,01 USDper credit · 1.500 per cap
Fiecare apel returnează un cap finalizat, nu un mesh chel.
Automatizarea merită doar dacă nimeni nu trebuie să finiseze rezultatul manual. Iată ce conține fiecare cap, fie că vine din API, de la un agent sau din aplicația web, fără costuri suplimentare.
- Fața, în topologie MetaHuman. Cap, gât și umeri, ochi și dinți. Aceeași ordine a vertex-urilor și aceleași UV-uri pe fiecare cap, așa că un singur rig se potrivește tuturor.
- Pielea proprie a persoanei. Hărți 4K de culoare de bază, normal, cavity și specular/roughness, în layout-ul UV al MetaHuman.
- Păr, sprâncene, gene și barbă, cu numele lor. Recomandări de groom MetaHuman cu valori de culoare, în
groom.json, pe care îl pot citi uneltele. - Un gât care se potrivește. Gâtul și trapezul urmează proporțiile proprii ale persoanei.
- 52 de forme ARKit. Create pentru această față, cu
tongueOutinclus, gata pentru face tracking și lip sync. - Șase formate. GLB, FBX, OBJ, STL, PLY și un MetaHuman ZIP. Le puteți cere pe oricare, de câte ori doriți.
Patru fotografii dificile
Lumină dură și riduri


Tenta portocalie a dispărut de pe piele; ridurile rămân ca relief.
Râs și ochelari


Râsul nu este încorporat în formă.
Barbă plină, cap întors


Maxilarul este recuperat; barba revine ca groom.
Păr peste urechi


Fața este a ei; forma urechilor nu se preia din fotografie.
Niciuna dintre aceste persoane nu există. Am generat fotografiile ca să putem testa fără chipul nimănui. Capetele sunt exact ceea ce a rezultat.
Vedeți exemplele.
Fiecare cap de aici a fost creat de FaceNinja dintr-o singură fotografie și este afișat exact așa cum a rezultat. Urmează mai multe exemple, cu mai multe tipuri de fețe, lumină și păr.












Încercați expresiile pe un cap creat de API.
Este aceeași previzualizare ușoară pe care o afișează aplicația web pentru fiecare cap. Fiecare buton comandă formele ARKit proprii ale capului. Activați previzualizarea părului ca să judecați asemănarea cu tot cu păr.
Capete de probă

Tastele săgeți rotesc capul. Plus și minus fac zoom. Zero resetează vederea. Escape închide vizualizatorul.
Valori ARKit
Valorile urmează expresia. Trageți un glisor ca să setați o formă.
Un cap sau cinci sute, același apel.
Un cap durează aproximativ 4 minute, așa că FaceNinja este asincron de la început. Trimiteți, primiți răspuns, preluați. Tot ce face ca un lot să poată rula în siguranță, fără supraveghere, este în API, iar skill-ul pentru agenți folosește același API.
Agentul dumneavoastră poate face asta.
- Creați un cont. Creați un cont cu Google sau cu adresa de e-mail și cumpărați credite.
- Lipiți un prompt în Claude Code, Codex, Cursor, Gemini CLI sau OpenClaw.
- Aprobați codul pe care agentul vi-l arată la
faceninja.net/device.
Apoi cereți mai mult: „un cap pentru fiecare subfolder din ./cast”, „fiecare cap din nou ca FBX”, „scrie-mi un pipeline cu webhook-uri”. Skill-ul vă spune costul și soldul înainte să cheltuiască și vă întreabă înainte de mai mult de 5 capete.
Codul dumneavoastră poate face asta.
- Chei de idempotență. Reîncercați o creare cu aceeași cheie și primiți același cap, niciodată o a doua taxare.
- Webhook-uri semnate.
head.completedșihead.failed, semnate înFaceNinja-Signature. Sau un canal de evenimente trimise de server, sau?waitpentru scripturi. - Loc pentru loturi. 30 de creări de capete și 600 de cereri pe minut pentru fiecare cont.
- Erori după care puteți ramifica codul. Coduri stabile, precum
no_faceșinot_same_person, fiecare cu o indicație. - Rambursări fără tichete. Creditele sunt rezervate la creare și eliberate de la sine dacă un cap eșuează.
- Linkuri, nu atașamente. Fiecare fișier vine ca link semnat, cu durată scurtă de viață. Păstrați ID-ul capului și cereți din nou când aveți nevoie.
POST /v1/headsfotografii ale unei persoane- ID-ul capului
head.completedwebhook semnat când este gataPOST /v1/heads/{id}/filesformat- link semnat, cu durată scurtă de viață
Automatizarea Unreal, care conformează fața, aplică pielea, pune groom-urile și alege un corp în Unreal Engine, este în acces timpuriu. Solicitați-o Acces timpuriu
Patru tipuri de pipeline, un singur tip de cap.
Unelte și platforme
Adăugați „fă un cap dintr-o fotografie” în produsul dumneavoastră. Webhook-uri primite, linkuri semnate returnate, rambursări fără tichete de suport.
DezvoltatoriStudiouri de jocuri
Fețe de jucători sau o distribuție de NPC-uri, toate pe un singur mesh, așa că un singur rig și un singur material se potrivesc fiecărui cap.
Capete pentru un jocCei care lucrează cu agenți
Dați sarcina lui Claude Code, Codex sau Cursor: o distribuție dintr-un folder, FBX pentru fiecare cap, un script de pipeline.
Pentru agenți AIArtiști tehnici
Deschideți MetaHuman Creator cu fața adaptată, pielea și groom-urile deja stabilite.
Ce conține un cap0,01 USD per credit, indiferent pe ce cale cereți.
API-ul, agentul și aplicația web consumă din același sold, la același preț. Cumpărați credite într-un pachet sau în orice sumă, fără abonament. Un cap costă 1.500 de credite, iar dacă eșuează, creditele lui se întorc de la sine. Taxa pe vânzări sau TVA-ul se adaugă la finalizarea comenzii, acolo unde se aplică.
Un cap, în browser.
Nu aveți nevoie de un agent sau de o cheie API. Conectați-vă cu Google, adăugați de la una până la 15 fotografii ale aceleiași persoane și descărcați capul după aproximativ 4 minute. Aplicația web afișează previzualizarea 3D, cu expresii și păr, înainte de descărcare.
Înainte să automatizați.
- 01Trebuie să scriu cod?
- Nu. Lipiți un prompt într-un agent AI precum Claude Code sau Cursor, sau folosiți aplicația web în browser. Pentru agenți AI
- 02Cât durează un cap?
- Aproximativ 4 minute de la încărcare. Când sunt multe capete în așteptare, al dumneavoastră intră la coadă, iar API-ul raportează locul în coadă.
- 03Câte fotografii îmi trebuie?
- O singură fotografie clară este suficientă. Până la 15 fotografii ale aceleiași persoane ajută, mai ales una de profil și una din trei sferturi. Sfaturi foto
- 04Ce se întâmplă dacă un cap eșuează?
- Cele 1.500 de credite ale lui se întorc în sold de la sine, iar
error.codespune de ce, de exempluno_face. - 05Părul face parte din cap?
- Nu. În MetaHuman, părul, sprâncenele și barba sunt groom-uri. Le recomandăm pe cele potrivite, cu culorile lor, ca date pe care le pot citi uneltele.
- 06Ale cui fotografii pot folosi?
- Ale dumneavoastră sau ale unui adult care a fost de acord să i se facă un cap 3D. Nu creăm capete ale copiilor și nici din fotografii găsite online. Utilizare acceptabilă EN
- 07Ce se întâmplă cu fotografiile mele?
- Sunt șterse după 30 de zile; puteți șterge și mai devreme un cap și fotografiile lui. Politica de confidențialitate EN
Primul dumneavoastră cap este la un prompt distanță.
Creați un cont, cumpărați credite, lipiți promptul și aprobați codul.