Z fotky na MetaHuman · API a AI agenti
Hlava je jedno volání API.
Pošlete fotky jednoho člověka ze svého kódu, nebo o to požádejte svého AI agenta. Asi o 4 minuty později dostanete hotovou 3D hlavu MetaHuman: vlastní pleť dané osoby ve 4K, doporučené groomy (vlasy MetaHuman), přiléhavý krk a 52 blendshapů ARKit, v šesti formátech. Hlava stojí 1 500 kreditů při 0,01 US$ za kredit. Nezdařená hlava nestojí nic.
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.Vložte do Claude Code, Codex, Cursor, Gemini CLI nebo OpenClaw. Schválíte kód; žádný klíč ke kopírování. Ponechte tento prompt v angličtině: váš agent potřebuje webovou adresu přesně tak, jak je napsaná. Pak s ním můžete mluvit svým jazykem.
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/faceninjaOkamžitě vrátí id hlavy. Až bude hotová, zavoláme váš webhook.
- 0,01 US$ za kredit, platíte podle spotřeby
- 1 500 kreditů za hlavu, všechny soubory v ceně
- Bez předplatného
- Kredity za nezdařené hlavy se vracejí




- 1Topologie MetaHumanStejné pořadí vrcholů a stejné UV na každé hlavě.
- 2Oči a zubyV důlcích; barva duhovky z fotky.
- 3Pleť ve 4KZákladní barva, normálová mapa, cavity, specular/roughness.
- 452 blendshapů ARKitVytvořené pro tuto tvář, včetně tongueOut.
- 5Přiléhavý krkKrk a trapézový sval odpovídají dané osobě.
Vstup: jedna fotka. Výstup: tato hlava, bez úprav. Syntetická osoba.
Táhněte, nebo klávesy ← →- Vstup
- 1 fotkaaž 15 od jedné osoby
- Topologie
- MetaHumanhlava, krk, ramena
- Výrazy
- 52 ARKitvytvořené pro tvář
- Mapy pleti
- 4 × 4Kbarva, normály, cavity, spec/rough
- Doba běhu
- asi 4 minna hlavu, jakoukoli cestou
- Sazba
- 0,01 US$za kredit · 1 500 na hlavu
Každé volání vrátí hotovou hlavu, ne holou síť.
Automatizace má smysl jen tehdy, když výsledek nikdo nemusí dodělávat ručně. Tohle obsahuje každá hlava, z API, od agenta i z webové aplikace, bez příplatku.
- Obličej v topologii MetaHuman. Hlava, krk a ramena, oči a zuby. Na každé hlavě stejné pořadí vrcholů a stejné UV, takže jeden rig sedí na všechny.
- Vlastní pleť dané osoby. Mapy základní barvy, normál, cavity a specular/roughness ve 4K, v UV rozvržení MetaHuman.
- Vlasy, obočí, řasy a vousy, pojmenované. Doporučené groomy MetaHuman s hodnotami barev, jako
groom.json, který přečtou vaše nástroje. - Krk, který sedí. Krk a trapézový sval odpovídají vlastním proporcím dané osoby.
- 52 blendshapů ARKit. Vytvořené pro tuto tvář, včetně
tongueOut, připravené pro sledování obličeje a lip sync. - Šest formátů. GLB, FBX, OBJ, STL, PLY a MetaHuman ZIP. Vyžádejte si kterýkoli, kolikrát chcete.
Čtyři obtížné fotky
Ostré světlo, vrásky


Oranžový nádech z pleti zmizel; vrásky zůstaly jako reliéf.
Smích a brýle


Smích není zapečený do tvaru.
Plnovous, otočená hlava


Čelist je obnovená; vousy se vracejí jako groom.
Vlasy přes uši


Obličej je její; tvar uší se z fotky nepřebírá.
Nikdo z těchto lidí neexistuje. Fotky jsme vygenerovali, abychom mohli testovat, aniž bychom použili něčí tvář. Hlavy jsou přesně to, co vyšlo.
Podívejte se na ukázky.
Každou zdejší hlavu vytvořil FaceNinja z jedné fotky a je ukázána přesně tak, jak vyšla. Další ukázky přibudou, s více druhy tváří, světla a vlasů.












Vyzkoušejte výrazy na hlavě, kterou vytvořilo API.
Je to stejný lehký náhled, jaký webová aplikace ukazuje u každé hlavy. Každé tlačítko ovládá vlastní blendshapy ARKit dané hlavy. Zapněte náhled vlasů, abyste mohli posoudit podobnost i s vlasy.
Ukázkové hlavy

Šipky otáčejí hlavou. Plus a mínus přibližují. Nula obnoví pohled. Escape opustí prohlížeč.
Hodnoty ARKit
Hodnoty sledují výraz. Posuvníkem nastavíte jeden tvar.
Jedna hlava, nebo pět set, pořád stejné volání.
Hlava trvá asi 4 minuty, takže FaceNinja je od začátku asynchronní. Odešlete požadavek, dostanete odpověď, stáhnete soubor. Vše, co umožňuje spouštět dávky bez dozoru, je v API, a skill pro agenty používá stejné API.
Váš agent to zvládne.
- Vytvořte účet. Založte si účet přes Google nebo e-mail a kupte kredity.
- Vložte jeden prompt do Claude Code, Codex, Cursor, Gemini CLI nebo OpenClaw.
- Schvalte kód který vám agent ukáže na
faceninja.net/device.
Pak žádejte další: „jedna hlava na každou podsložku ./cast“, „každou hlavu znovu jako FBX“, „napište mi pipeline s webhooky“. Skill vám před každým výdajem sdělí cenu i váš zůstatek a zeptá se vás, než vytvoří více než 5 hlav.
Váš kód to zvládne.
- Klíče idempotence. Zopakujte vytvoření se stejným klíčem a dostanete stejnou hlavu, nikdy druhou platbu.
- Podepsané webhooky.
head.completedahead.failed, podepsané vFaceNinja-Signature. Nebo proud server-sent událostí, nebo?waitpro skripty. - Prostor pro dávky. 30 vytvoření hlav a 600 požadavků za minutu na účet.
- Chyby, podle kterých lze větvit kód. Stabilní kódy jako
no_faceanot_same_person, každý s nápovědou. - Vrácení bez tiketů. Kredity se při vytvoření zadrží a samy se uvolní, když hlava selže.
- Odkazy, ne přílohy. Každý soubor přijde jako krátkodobý podepsaný odkaz. Uložte si id hlavy a zeptejte se znovu, až soubor budete potřebovat.
POST /v1/headsfotky jedné osoby- id hlavy
head.completedpodepsaný webhook, až bude hotovoPOST /v1/heads/{id}/filesformát- krátkodobý podepsaný odkaz
Automatizace pro Unreal, která v Unreal Engine přizpůsobí obličej, nastaví pleť, nasadí groomy a vybere tělo, je v předběžném přístupu. Požádejte o ni Předběžný přístup
Čtyři druhy pipeline, jeden druh hlavy.
Nástroje a platformy
Přidejte do svého produktu „vytvoř hlavu z fotky“. Webhooky dovnitř, podepsané odkazy ven, vrácení bez tiketů podpory.
VývojářiHerní studia
Tváře hráčů nebo obsazení NPC, vše na jedné síti, takže jeden rig a jeden materiál sedí na každou hlavu.
Hlavy pro hruLidé, kteří pracují s agenty
Svěřte práci agentům jako Claude Code, Codex nebo Cursor: obsazení ze složky, FBX pro každou hlavu, skript pipeline.
Použít s AI agentyTechnical artisti
Otevřete MetaHuman Creator s hotovým přizpůsobením obličeje, pletí a groomy.
Co je v hlavě0,01 US$ za kredit, ať hlavu objednáte jakkoli.
API, váš agent i webová aplikace čerpají z jednoho zůstatku za jednu cenu. Kredity kupte v balíčku nebo v libovolné výši, bez předplatného. Hlava stojí 1 500 kreditů, a když selže, její kredity se samy vrátí. Daň z prodeje nebo DPH se tam, kde platí, přičte při platbě.
Jedna hlava, v prohlížeči.
Nepotřebujete agenta ani klíč API. Přihlaste se přes Google, nahrajte 1 až 15 fotek jednoho člověka a hlavu si stáhněte asi za 4 minuty. Webová aplikace před stažením ukáže 3D náhled s výrazy a vlasy.
Než začnete automatizovat.
- 01Musím psát kód?
- Ne. Vložte jeden prompt do AI agenta, například Claude Code nebo Cursor, nebo použijte webovou aplikaci v prohlížeči. Použít s AI agenty
- 02Jak dlouho hlava trvá?
- Asi 4 minuty od nahrání. Když čeká mnoho hlav, ta vaše počká ve frontě a API hlásí její pořadí.
- 03Kolik fotek potřebuji?
- Stačí jedna ostrá fotka. Pomůže až 15 fotek téhož člověka, zvlášť profil a pohled ze tří čtvrtin. Tipy k fotkám
- 04Co se stane, když hlava selže?
- Jejích 1 500 kreditů se samo vrátí na váš zůstatek a
error.codeřekne proč, napříkladno_face. - 05Jsou vlasy součástí hlavy?
- Ne. V MetaHuman jsou vlasy, obočí a vousy groomy. Doporučíme ty správné i s jejich barvami, jako data, která vaše nástroje přečtou.
- 06Čí fotky smím použít?
- Vaše vlastní, nebo fotky dospělého člověka, který souhlasil s vytvořením své 3D hlavy. Nevytváříme hlavy dětí ani podle fotek nalezených online. Přijatelné užívání EN
- 07Co se stane s mými fotkami?
- Po 30 dnech se smažou a hlavu i její fotky můžete smazat dříve. Zásady ochrany soukromí EN
Vaše první hlava je na dosah jednoho promptu.
Vytvořte účet, kupte kredity, vložte prompt a schvalte kód.