Valokuva → MetaHuman · API ja tekoälyagentit
3D-pää on yksi API-kutsu.
Lähetä henkilön valokuvia koodistasi tai pyydä tekoälyagenttiasi tekemään se. Noin 4 minuutin kuluttua saat valmiin MetaHuman-pään: henkilön oman ihon 4K-tarkkuudella, groom-suositukset (MetaHuman-hiukset), sovitetun kaulan ja 52 ARKit-muotoa kuudessa tiedostomuodossa. 3D-pää maksaa 1 500 krediittiä, 0,01 $ per krediitti, ja epäonnistunut 3D-pää ei maksa mitään.
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.Liitä kehote agenttiisi: Claude Code, Codex, Cursor, Gemini CLI tai OpenClaw. Hyväksyt koodin; avainta ei tarvitse kopioida. Pidä tämä kehote englanniksi: agenttisi tarvitsee verkko-osoitteen täsmälleen kirjoitetussa muodossa. Sen jälkeen voit puhua sille omalla kielelläsi.
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/faceninjaPalauttaa 3D-pään id-tunnuksen heti. Kutsumme webhookiasi, kun se on valmis.
- 0,01 $ per krediitti, maksu käytön mukaan
- 1 500 krediittiä per 3D-pää, kaikki tiedostot mukana
- Ei tilausta
- Epäonnistuneet 3D-päät hyvitetään




- 1MetaHuman-topologiaSama verteksijärjestys ja samat UV:t jokaisessa 3D-päässä.
- 2Silmät ja hampaatKuopissaan; iiriksen väri valokuvasta.
- 3Iho 4K-tarkkuudellaPerusväri, normaali, cavity, specular/roughness.
- 452 ARKit-muotoaTehty näille kasvoille, tongueOut mukaan lukien.
- 5Sopiva kaulaKaula ja epäkäslihas mukailevat henkilöä.
Sisään: yksi valokuva. Ulos: tämä 3D-pää, koskemattomana. Synteettinen henkilö.
Vedä tai fokusoi ja käytä ← →- Syöte
- 1 valokuvaenintään 15, yksi henkilö
- Topologia
- MetaHumanpää, kaula, hartiat
- Ilmeet
- 52 ARKittehty kasvoille
- Ihokartat
- 4 × 4Kväri, normaali, cavity, spec/rough
- Kesto
- noin 4 minper 3D-pää, reitistä riippumatta
- Hinta
- 0,01 $per krediitti · 1 500 per 3D-pää
Jokainen kutsu palauttaa valmiin 3D-pään, ei pelkkää kaljua meshiä.
Automaatio kannattaa vain, jos kenenkään ei tarvitse viimeistellä tulosta käsin. Tässä on, mitä jokainen 3D-pää sisältää riippumatta siitä, tuleeko se API:sta, agentilta vai verkkosovelluksesta, ilman lisämaksua.
- Kasvot MetaHuman-topologialla. Pää, kaula ja hartiat, silmät ja hampaat. Sama verteksijärjestys ja samat UV:t jokaisessa 3D-päässä, joten yksi rigi sopii kaikkiin.
- Henkilön oma iho. 4K-kartat: perusväri, normaali, cavity ja specular/roughness, MetaHuman-UV-asettelussa.
- Hiukset, kulmat, ripset ja parta nimettyinä. Suositellut MetaHuman-groomit väriarvoineen
groom.json-tiedostona, jonka työkalusi osaavat lukea. - Sopiva kaula. Kaula ja epäkäslihas noudattavat henkilön omia mittasuhteita.
- 52 ARKit-muotoa. Tehty näille kasvoille,
tongueOutmukaan lukien, valmiina kasvojenseurantaan ja huulisynkronointiin. - Kuusi tiedostomuotoa. GLB, FBX, OBJ, STL, PLY ja MetaHuman ZIP. Pyydä mitä tahansa niistä, niin usein kuin haluat.
Neljä vaikeaa valokuvaa
Kova valo, syvät rypyt


Oranssi sävy on poissa ihosta; rypyt jäävät reliefinä.
Nauru ja silmälasit


Nauru ei tallennu muotoon.
Täysparta, pää sivulle


Leuka palautetaan; parta tulee takaisin groomina.
Hiukset korvien päällä


Kasvot ovat hänen; korvien muotoa ei oteta valokuvasta.
Näitä ihmisiä ei ole olemassa. Loimme valokuvat, jotta voimme testata käyttämättä kenenkään kasvoja. 3D-päät ovat täsmälleen sellaisia kuin ne tulivat ulos.
Katso näytteet.
Jokainen täällä näkyvä 3D-pää on FaceNinjan tekemä yhdestä valokuvasta, ja se näytetään täsmälleen sellaisena kuin se syntyi. Lisää näytteitä on tulossa, ja mukaan tulee erilaisempia kasvoja, valoja ja hiuksia.












Kokeile ilmeitä API:n tekemällä 3D-päällä.
Tämä on sama kevyt esikatselu, jonka verkkosovellus näyttää jokaisesta 3D-päästä. Jokainen painike ohjaa 3D-pään omia ARKit-muotoja. Kytke hiusesikatselu päälle, jotta näet, miten hyvin 3D-pää muistuttaa henkilöä hiuksineen.
Näytepäät

Nuolinäppäimet kääntävät päätä. Plus ja miinus zoomaavat. Nolla palauttaa näkymän. Escape poistuu katselimesta.
ARKit-arvot
Arvot seuraavat ilmettä. Säädä yksi muoto vetämällä liukusäädintä.
Yksi 3D-pää tai viisisataa, sama kutsu.
3D-pää kestää noin 4 minuuttia, joten FaceNinja on alusta asti asynkroninen. Lähetät, saat vastauksen ja haet. Kaikki, mikä tekee erästä turvallisen ajaa valvomatta, on API:ssa, ja agentin skill käyttää samaa API:a.
Agenttisi hoitaa sen.
- Luo tili. Luo tili Googlella tai sähköpostilla ja osta krediittejä.
- Liitä yksi kehote agenttiisi: Claude Code, Codex, Cursor, Gemini CLI tai OpenClaw.
- Hyväksy koodi jonka agenttisi näyttää osoitteessa
faceninja.net/device.
Pyydä sitten lisää: ”yksi 3D-pää jokaista ./cast-kansion alikansiota kohden”, ”kaikki 3D-päät uudelleen FBX-muodossa”, ”kirjoita minulle webhook-pohjainen tuotantoputki”. Skill kertoo hinnan ja saldosi ennen kuin se kuluttaa mitään, ja kysyy lupaa, jos 3D-päitä on yli 5.
Koodisi hoitaa sen.
- Idempotenssiavaimet. Yritä luontia uudelleen samalla avaimella, niin saat saman 3D-pään, et koskaan toista veloitusta.
- Allekirjoitetut webhookit.
head.completedjahead.failed, allekirjoitettuinaFaceNinja-Signature-otsakkeessa. Tai palvelimen lähettämien tapahtumien virta, tai?waitskripteille. - Tilaa erille. 30 3D-pään luontia ja 600 pyyntöä minuutissa tiliä kohden.
- Virheet, joiden mukaan voi haarautua. Vakaat koodit kuten
no_facejanot_same_person, kullakin vihje. - Hyvitykset ilman tukipyyntöjä. Krediitit varataan luontihetkellä ja vapautuvat itsestään, jos 3D-pää epäonnistuu.
- Linkkejä, ei liitteitä. Jokainen tiedosto tulee lyhytikäisenä allekirjoitettuna linkkinä. Tallenna 3D-pään id ja pyydä uudelleen, kun tarvitset tiedostoa.
POST /v1/headsyhden henkilön valokuvat- 3D-pään id
head.completedallekirjoitettu webhook, kun valmisPOST /v1/heads/{id}/filestiedostomuoto- lyhytikäinen allekirjoitettu linkki
Unreal-automaatio, joka sovittaa kasvot, asettaa ihon, lisää groomit ja valitsee vartalon Unreal Engine -ohjelmassa, on ennakkokäytössä. Pyydä sitä Ennakkokäyttö
Neljänlaisia tuotantoputkia, yhdenlaisia 3D-päitä.
Työkalut ja alustat
Lisää tuotteeseesi ”tee 3D-pää valokuvasta”. Webhookit sisään, allekirjoitetut linkit ulos, hyvitykset ilman tukipyyntöjä.
KehittäjätPelistudiot
Pelaajien kasvot tai NPC-hahmosto, kaikki samalla meshillä, joten yksi rigi ja yksi materiaali sopivat jokaiseen 3D-päähän.
3D-päät peliinAgenttien käyttäjät
Anna työ agentille (Claude Code, Codex tai Cursor): hahmosto kansiosta, FBX jokaiselle 3D-päälle, tuotantoputken skripti.
Käytä tekoälyagenttien kanssaTekniset artistit
Avaa MetaHuman Creator niin, että sovitus, iho ja groomit on jo päätetty.
Mitä 3D-päässä on0,01 $ per krediitti, mitä reittiä tahansa.
API, agenttisi ja verkkosovellus käyttävät yhtä saldoa yhdellä hinnalla. Osta krediittejä paketissa tai vapaavalintaisena määränä, ilman tilausta. 3D-pää maksaa 1 500 krediittiä, ja jos se epäonnistuu, sen krediitit palautuvat itsestään. Myyntivero tai ALV lisätään kassalla, jos se koskee ostoasi.
Yksi 3D-pää selaimessa.
Agenttia tai API-avainta ei tarvita. Kirjaudu sisään Googlella, lisää 1–15 valokuvaa yhdestä henkilöstä ja lataa 3D-pää noin 4 minuutissa. Verkkosovellus näyttää 3D-esikatselun ilmeineen ja hiuksineen ennen latausta.
Ennen automatisointia.
- 01Pitääkö minun kirjoittaa koodia?
- Ei. Liitä yksi kehote tekoälyagenttiin (esimerkiksi Claude Code tai Cursor) tai käytä verkkosovellusta selaimessa. Käytä tekoälyagenttien kanssa
- 02Kuinka kauan 3D-pään teko kestää?
- Noin 4 minuuttia latauksesta. Kun monta 3D-päätä odottaa, omasi jonottaa, ja API kertoo sen paikan jonossa.
- 03Montako valokuvaa tarvitsen?
- Yksi terävä valokuva riittää. Jopa 15 valokuvaa samasta henkilöstä auttaa, etenkin sivuprofiili ja kolmeneljäsosaprofiili. Kuvausvinkit
- 04Mitä tapahtuu, jos 3D-pää epäonnistuu?
- Sen 1 500 krediittiä palautuvat saldollesi itsestään, ja
error.codekertoo syyn, esimerkiksino_face. - 05Kuuluvatko hiukset 3D-päähän?
- Ei. MetaHumanissa hiukset, kulmat ja parrat ovat groomeja. Suosittelemme sopivat groomit väriarvoineen datana, jota työkalusi osaavat lukea.
- 06Kenen valokuvia voin käyttää?
- Omiasi tai sellaisen aikuisen valokuvia, joka on suostunut siihen, että hänestä tehdään 3D-pää. Emme tee 3D-päitä lapsista emmekä verkosta löydetyistä valokuvista. Hyväksyttävä käyttö EN
- 07Mitä valokuvilleni tapahtuu?
- Ne poistetaan 30 päivän kuluttua, ja 3D-pään ja sen valokuvat voi poistaa aiemminkin. Tietosuojakäytäntö EN
Ensimmäinen 3D-pääsi on yhden kehotteen päässä.
Luo tili, osta krediittejä, liitä kehote ja hyväksy koodi.