Fotóból MetaHuman · API és AI-ügynökök
Egy fej egy API-hívás.
Küldd el egy ember fotóit a kódodból, vagy kérd meg rá az AI-ügynöködet. Körülbelül 4 perc múlva kész MetaHuman-fejet kapsz: a személy saját bőrét 4K-ban, ajánlott groomokat (MetaHuman-haj), illeszkedő nyakat és 52 ARKit blendshape-et, hat formátumban. Egy fej 1500 kredit, kreditenként 0,01 USD, a sikertelen fej pedig nem kerül semmibe.
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.Illeszd be valamelyik ügynökbe: Claude Code, Codex, Cursor, Gemini CLI vagy OpenClaw. Egy kódot hagysz jóvá; kulcsot nem kell másolnod. Hagyd angolul ezt a promptot: az ügynöknek pontosan így kell megkapnia a webcímet. Utána a saját nyelveden beszélhetsz vele.
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/faceninjaA fej azonosítóját azonnal visszaadja. Ha elkészült, meghívjuk a webhookodat.
- 0,01 USD kreditenként, használat szerint fizetve
- 1500 kredit egy fej, minden fájllal együtt
- Nincs előfizetés
- Sikertelen fejnél visszajár a kredit
- 1MetaHuman-topológiaMinden fejen ugyanaz a vertexsorrend és ugyanaz az UV-kiosztás.
- 2Szem és fogakA helyükön ülnek; az írisz színe a fotóból.
- 34K bőrAlapszín, normal, cavity, specular/roughness.
- 452 ARKit blendshapeEhhez az archoz készítve, a tongueOut is benne van.
- 5Illeszkedő nyakA nyak és a trapézizom a személyhez igazodik.
Be: egy fotó. Ki: ez a fej, érintetlenül. Szintetikus személy.
Húzd, vagy fókusz után ← →- Bemenet
- 1 fotólegfeljebb 15, egy személyről
- Topológia
- MetaHumanfej, nyak, vállak
- Kifejezések
- 52 ARKitaz archoz készítve
- Bőrtextúrák
- 4 × 4Kszín, normal, cavity, spec/rough
- Futási idő
- körülbelül 4 percfejenként, bármelyik módon
- Díj
- 0,01 USDkreditenként · fejenként 1500
Minden hívás kész fejet ad vissza, nem kopasz fejhálót.
Az automatizálás csak akkor ér valamit, ha az eredményt senkinek sem kell kézzel befejeznie. Ezt tartalmazza minden fej, akár az API-ból, akár egy ügynöktől, akár a webalkalmazásból érkezik, felár nélkül.
- Az arc, MetaHuman-topológiában. Fej, nyak és vállak, szemek és fogak. Minden fejen ugyanaz a vertexsorrend és ugyanaz az UV-kiosztás, ezért egyetlen rig mindegyikhez illik.
- A személy saját bőre. 4K-s alapszín-, normal-, cavity- és specular/roughness-textúrák, a MetaHuman UV-kiosztásában.
- Haj, szemöldök, szempilla és szakáll, néven nevezve. MetaHuman groom-ajánlások színértékekkel,
groom.jsonformában, amelyet az eszközeid olvasni tudnak. - Illeszkedő nyak. A nyak és a trapézizom a személy saját arányait követi.
- 52 ARKit blendshape. Ehhez az archoz készítve, a
tongueOutis benne van, arckövetéshez és lip synchez. - Hat formátum. GLB, FBX, OBJ, STL, PLY és egy MetaHuman ZIP. Bármelyiket kérheted, ahányszor csak akarod.
Négy nehéz fotó
Kemény fény, mély ráncok
A narancsos színezet lekerült a bőrről; a ráncok domborzatként megmaradnak.
Nevetés és szemüveg
A nevetés nem ég bele a formába.
Szakáll, elfordított fej
Az állkapocs helyreáll; a szakáll groomként tér vissza.
Fület takaró haj
Az arc az övé; a fül alakját nem a fotóból vesszük át.
Ezek az emberek nem léteznek. A fotókat mi generáltuk, hogy bárki arca nélkül tudjunk tesztelni. A fejek pontosan olyanok, ahogy kijöttek.
Nézd meg a mintákat.
Minden itteni fejet a FaceNinja készített egyetlen fotóból, és pontosan úgy látható, ahogy kijött. További minták várhatók, többféle arccal, fénnyel és hajjal.
Próbáld ki az arckifejezéseket egy olyan fejen, amelyet az API készített.
Ez ugyanaz a könnyű előnézet, amelyet a webalkalmazás minden fejhez mutat. Minden gomb a fej saját ARKit blendshape-jeit hajtja. Kapcsold be a hajelőnézetet, hogy hajjal is megítélhesd a hasonlóságot.
Mintafejek
Nyílbillentyűk: a fej forgatása. Plusz és mínusz: nagyítás. Nulla: alaphelyzet. Escape: kilépés a nézegetőből.
ARKit-értékek
Az értékek követik a kifejezést. Egy blendshape csúszkával állítható.
Egy fej vagy ötszáz, ugyanaz a hívás.
Egy fej körülbelül 4 percig készül, ezért a FaceNinja kezdettől fogva aszinkron. Elküldöd, visszahívunk, letöltöd. Minden, ami miatt egy köteg felügyelet nélkül is biztonságosan futtatható, az API-ban van, és az ügynök-skill ugyanezt az API-t használja.
Megcsinálhatja az ügynököd.
- Hozz létre fiókot. Regisztrálj Google-lel vagy e-mail-címmel, és vegyél kreditet.
- Illessz be egy promptot valamelyik ügynökbe: Claude Code, Codex, Cursor, Gemini CLI vagy OpenClaw.
- Hagyd jóvá a kódot, amelyet az ügynököd mutat neked a
faceninja.net/devicecímen.
Aztán kérj többet: „egy fej a ./cast minden almappájához”, „minden fejet újra FBX-ben”, „írj nekem egy webhook-pipeline-t”. A skill költés előtt megmondja az árat és az egyenlegedet, és 5-nél több fej előtt rákérdez.
Megcsinálhatja a kódod.
- Idempotencia-kulcsok. Ha ugyanazzal a kulccsal próbálod újra a létrehozást, ugyanazt a fejet kapod, és soha nem terhelünk kétszer.
- Aláírt webhookok.
head.completedéshead.failed, aláírva aFaceNinja-Signaturefejlécben. Vagy server-sent event stream, vagy?waitszkriptekhez. - Hely a kötegeknek. Fiókonként percenként 30 fej létrehozása és 600 kérés.
- Hibakódok, amelyekre elágazhatsz. Stabil kódok, például
no_faceésnot_same_person, mindegyikhez egy tippel. - Visszatérítés ticket nélkül. A kreditek létrehozáskor zárolódnak, és ha a fej sikertelen, maguktól felszabadulnak.
- Linkek, nem csatolmányok. Minden fájl rövid életű, aláírt linkként érkezik. Tárold el a fej azonosítóját, és kérd újra, ha kell.
POST /v1/headsegy személy fotói- fej-azonosító
head.completedaláírt webhook, ha készPOST /v1/heads/{id}/filesformátum- rövid életű, aláírt link
Az Unreal-automatizálás, amely az Unreal Engine-ben illeszti az arcot, beállítja a bőrt, felteszi a groomokat és kiválaszt egy testet, korai hozzáférésben érhető el. Kérd el Korai hozzáférés
Négyféle pipeline, egyféle fej.
Eszközök és platformok
Add hozzá a termékedhez a „fej készítése fotóból” funkciót. Webhookok be, aláírt linkek ki, visszatérítés ügyfélszolgálati jegyek nélkül.
Fejlesztők
Játékstúdiók
Játékosarcok vagy NPC-szereplőgárda, mind egyetlen hálón, így egyetlen rig és egyetlen anyag illik minden fejhez.
Fejek játékhoz
Ügynökökkel dolgozók
Bízd a munkát egy ügynökre (Claude Code, Codex vagy Cursor): szereplőgárda egy mappából, FBX minden fejhez, egy pipeline-szkript.
AI-ügynök használata
Technical artistok
A MetaHuman Creator úgy nyílik meg, hogy az illesztés, a bőr és a groomok már eldőltek.
Mi van egy fejbenKreditenként 0,01 USD, akárhogy kéred.
Az API, az ügynököd és a webalkalmazás egyetlen egyenlegből dolgozik, egyetlen áron. Vegyél kreditet csomagban vagy tetszőleges összegben, előfizetés nélkül. Egy fej 1500 kredit, és ha sikertelen, a kreditjei maguktól visszakerülnek. Ahol ez érvényes, az áfát vagy az értékesítési adót a fizetésnél számoljuk hozzá.
Egy fej, a böngészőben.
Nincs szükséged ügynökre vagy API-kulcsra. Jelentkezz be Google-lel, tölts fel 1–15 fotót egy személyről, és körülbelül 4 perc múlva töltsd le a fejet. A webalkalmazás letöltés előtt megmutatja a 3D-előnézetet kifejezésekkel és hajjal.
Mielőtt automatizálsz.
- 01Kell kódot írnom?
- Nem. Illessz be egy promptot egy AI-ügynökbe (például Claude Code vagy Cursor), vagy használd a webalkalmazást a böngésződben. AI-ügynök használata
- 02Mennyi ideig tart egy fej?
- Feltöltéstől számítva körülbelül 4 perc. Ha sok fej vár, a tiéd sorban áll, és az API megmondja a helyét a sorban.
- 03Hány fotóra van szükségem?
- Egy éles fotó elég. Legfeljebb 15 fotó ugyanarról a személyről segít, főleg egy profil- és egy háromnegyedes nézet. Fotótippek
- 04Mi történik, ha egy fej sikertelen?
- A fej 1500 kreditje magától visszakerül az egyenlegedre, az
error.codepedig megmondja az okot, példáulno_face. - 05A haj a fej része?
- Nem. A MetaHuman-fejeknél a haj, a szemöldök és a szakáll groom. A megfelelőket ajánljuk, színeikkel együtt, az eszközeid által olvasható adatként.
- 06Kinek a fotóit használhatom?
- A sajátodat, vagy egy olyan felnőttét, aki beleegyezett, hogy 3D-fejet készítsenek róla. Nem készítünk fejet gyerekekről, sem az interneten talált fotókból. Elfogadható használat EN
- 07Mi történik a fotóimmal?
- 30 nap után törlődnek, és egy fejet a fotóival együtt korábban is törölhetsz. Adatvédelmi szabályzat EN
Az első fejed egyetlen prompt távolságra van.
Hozz létre fiókot, vegyél kreditet, illeszd be a promptot, és hagyd jóvá a kódot.