Zdjęcie do MetaHuman · API i agenci AI
Głowa to wywołanie API.
Wyślij zdjęcia osoby ze swojego kodu albo poproś o to agenta AI. Po około 4 minutach dostajesz gotową głowę MetaHuman: własną skórę tej osoby w 4K, rekomendacje groomów (włosów MetaHuman), dopasowaną szyję i 52 kształty ARKit, w sześciu formatach. Głowa to 1500 kredytów po 0,01 USD za kredyt, a nieudana głowa nic nie kosztuje.
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.Wklej do Claude Code, Codex, Cursor, Gemini CLI lub OpenClaw. Zatwierdzasz kod; żadnego klucza nie kopiujesz. Zostaw ten prompt po angielsku: agent potrzebuje adresu dokładnie w tej postaci. Potem możesz rozmawiać z nim we własnym języku.
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/faceninjaOd razu zwraca identyfikator głowy. Gdy będzie gotowa, wywołamy twój webhook.
- 0,01 USD za kredyt, płatność za użycie
- 1500 kredytów na głowę, wszystkie pliki w cenie
- Bez subskrypcji
- Zwrot za nieudane głowy




- 1Topologia MetaHumanTa sama kolejność wierzchołków i UV w każdej głowie.
- 2Oczy i zębyOsadzone w oczodołach; kolor tęczówki ze zdjęcia.
- 3Skóra w 4KKolor bazowy, normalne, cavity, specular/roughness.
- 452 kształty ARKitZrobione pod tę twarz, wraz z tongueOut.
- 5Szyja, która pasujeSzyja i mięsień czworoboczny podążają za osobą.
Wejście: jedno zdjęcie. Wyjście: ta głowa, bez poprawek. Osoba syntetyczna.
Przeciągnij lub użyj ← →- Wejście
- 1 zdjęciedo 15 zdjęć jednej osoby
- Topologia
- MetaHumangłowa, szyja, ramiona
- Mimika
- 52 ARKitzrobione pod twarz
- Mapy skóry
- 4 × 4Kkolor, normalne, cavity, spec/rough
- Czas
- około 4 minna głowę, każdą drogą
- Stawka
- 0,01 USDza kredyt · 1500 na głowę
Każde wywołanie zwraca gotową głowę, a nie łysą siatkę.
Automatyzacja ma sens tylko wtedy, gdy nikt nie musi ręcznie kończyć wyniku. Oto, co zawiera każda głowa, z API, od agenta czy z aplikacji webowej, bez dopłat.
- Twarz w topologii MetaHuman. Głowa, szyja i ramiona, oczy i zęby. Ta sama kolejność wierzchołków i UV w każdej głowie, więc jeden rig pasuje do wszystkich.
- Własna skóra tej osoby. Mapy 4K: kolor bazowy, normalne, cavity i specular/roughness, w układzie UV MetaHuman.
- Włosy, brwi, rzęsy i broda, z nazwami. Rekomendacje groomów MetaHuman z wartościami kolorów, jako
groom.json, który odczytają twoje narzędzia. - Szyja, która pasuje. Szyja i mięsień czworoboczny podążają za własnymi proporcjami osoby.
- 52 kształty ARKit. Zrobione pod tę twarz, wraz z
tongueOut, gotowe do śledzenia twarzy i lip sync. - Sześć formatów. GLB, FBX, OBJ, STL, PLY i MetaHuman ZIP. Poproś o dowolny z nich, tyle razy, ile chcesz.
Cztery trudne zdjęcia
Ostre światło, bruzdy


Ze skóry zniknęła pomarańczowa dominanta barwna; zmarszczki zostają jako relief.
Śmiech i okulary


Śmiech nie zostaje w kształcie głowy.
Pełna broda, głowa w bok


Szczęka zostaje odtworzona; broda wraca jako groom.
Włosy zakrywają uszy


Twarz jest jej; kształt uszu nie pochodzi ze zdjęcia.
Żadna z tych osób nie istnieje. Zdjęcia wygenerowaliśmy, żeby testować bez czyjejkolwiek twarzy. Głowy są dokładnie takie, jakie wyszły.
Zobacz przykłady.
Każda głowa tutaj powstała w FaceNinja z jednego zdjęcia i jest pokazana dokładnie taka, jaka wyszła. Kolejne przykłady wkrótce, z większą różnorodnością twarzy, światła i włosów.












Wypróbuj mimikę na głowie zrobionej przez API.
To ten sam lekki podgląd, który aplikacja webowa pokazuje przy każdej głowie. Każdy przycisk steruje własnymi kształtami ARKit tej głowy. Włącz podgląd włosów, by ocenić podobieństwo z włosami.
Przykładowe głowy

Strzałki obracają głowę. Plus i minus zmieniają zoom. Zero resetuje widok. Escape zamyka podgląd.
Odczyt ARKit
Wartości podążają za mimiką. Suwak ustawia jeden kształt.
Jedna głowa albo pięćset, to samo wywołanie.
Zrobienie głowy trwa około 4 minut, więc FaceNinja jest asynchroniczny od początku. Wysyłasz, dostajesz odpowiedź, pobierasz. Wszystko, co pozwala bezpiecznie uruchomić partię bez nadzoru, jest w API, a skill agenta używa tego samego API.
Twój agent to zrobi.
- Załóż konto. Załóż konto przez Google lub e-mail i kup kredyty.
- Wklej jeden prompt do Claude Code, Codex, Cursor, Gemini CLI lub OpenClaw.
- Zatwierdź kod, który agent pokaże ci na
faceninja.net/device.
Potem poproś o więcej: „po jednej głowie na podfolder ./cast”, „każdą głowę jeszcze raz jako FBX”, „napisz mi pipeline na webhookach”. Skill podaje koszt i twoje saldo, zanim wyda kredyty, i pyta, zanim zleci więcej niż 5 głów.
Twój kod to zrobi.
- Klucze idempotentności. Ponów utworzenie z tym samym kluczem, a dostaniesz tę samą głowę, bez drugiej opłaty.
- Podpisane webhooki.
head.completedihead.failed, podpisane wFaceNinja-Signature. Albo strumień server-sent events, albo?waitdla skryptów. - Miejsce na partie. 30 utworzeń głów i 600 żądań na minutę na konto.
- Błędy, na które można reagować w kodzie. Stabilne kody, takie jak
no_faceinot_same_person, każdy z podpowiedzią. - Zwroty bez zgłoszeń. Kredyty są blokowane przy utworzeniu i same zwalniane, jeśli głowa się nie uda.
- Linki, nie załączniki. Każdy plik to krótko ważny, podpisany link. Zapisz identyfikator głowy, a gdy będzie potrzebny, zapytaj ponownie.
POST /v1/headszdjęcia jednej osoby- identyfikator głowy
head.completedpodpisany webhook, gdy głowa jest gotowaPOST /v1/heads/{id}/filesformat- krótko ważny, podpisany link
Automatyzacja Unreal, która dopasowuje twarz, ustawia skórę, nakłada groomy i wybiera ciało wewnątrz Unreal Engine, jest we wczesnym dostępie. Poproś o nią Wczesny dostęp
Cztery rodzaje pipeline’ów, jeden rodzaj głowy.
Narzędzia i platformy
Dodaj do swojego produktu „zrób głowę ze zdjęcia”. Webhooki na wejściu, podpisane linki na wyjściu, zwroty bez zgłoszeń do wsparcia.
ProgramiściStudia gier
Twarze graczy albo obsada NPC, wszystko na jednej siatce, więc jeden rig i jeden materiał pasują do każdej głowy.
Głowy do gryOsoby pracujące z agentami
Zleć zadanie Claude Code, Codex lub Cursor: obsada z folderu, FBX dla każdej głowy, skrypt pipeline’u.
Użyj z agentami AITechnical artyści
Otwórz MetaHuman Creator, gdy dopasowanie twarzy, skóra i groomy są już ustalone.
Co zawiera głowa0,01 USD za kredyt, niezależnie od drogi.
API, twój agent i aplikacja webowa czerpią z jednego salda po jednej cenie. Kredyty kupujesz w pakiecie lub w dowolnej kwocie, bez subskrypcji. Głowa to 1500 kredytów, a jeśli się nie uda, jej kredyty wracają same. Tam, gdzie obowiązuje, podatek od sprzedaży lub VAT jest doliczany przy płatności.
Jedna głowa, w przeglądarce.
Nie potrzebujesz agenta ani klucza API. Zaloguj się przez Google, wrzuć od jednego do 15 zdjęć jednej osoby i pobierz głowę po około 4 minutach. Aplikacja webowa pokazuje przed pobraniem podgląd 3D z mimiką i włosami.
Zanim zautomatyzujesz.
- 01Czy muszę pisać kod?
- Nie. Wklej jeden prompt do agenta AI, takiego jak Claude Code czy Cursor, albo użyj aplikacji webowej w przeglądarce. Użyj z agentami AI
- 02Ile trwa zrobienie głowy?
- Około 4 minut od wysłania zdjęć. Gdy czeka wiele głów, twoja ustawia się w kolejce, a API podaje jej miejsce w kolejce.
- 03Ile zdjęć potrzebuję?
- Wystarczy jedno ostre zdjęcie. Pomaga do 15 zdjęć tej samej osoby, zwłaszcza profil i ujęcie z trzech czwartych. Porady do zdjęć
- 04Co się dzieje, gdy głowa się nie uda?
- Jej 1500 kredytów wraca na twoje saldo samoczynnie, a
error.codepodaje powód, na przykładno_face. - 05Czy włosy są częścią głowy?
- Nie. W MetaHuman włosy, brwi i brody to groomy. Rekomendujemy właściwe, razem z ich kolorami, jako dane, które odczytają twoje narzędzia.
- 06Czyich zdjęć mogę używać?
- Własnych albo zdjęć dorosłej osoby, która zgodziła się na wykonanie jej głowy 3D. Nie robimy głów dzieci ani ze zdjęć znalezionych w sieci. Dopuszczalne użycie EN
- 07Co dzieje się z moimi zdjęciami?
- Są usuwane po 30 dniach, a głowę i jej zdjęcia możesz usunąć wcześniej. Polityka prywatności EN
Twoja pierwsza głowa jest o jeden prompt stąd.
Załóż konto, kup kredyty, wklej prompt i zatwierdź kod.