FaceNinja

Agenci AI · Claude Code, Codex, Cursor, Gemini CLI, OpenClaw

Twój agent AI może robić głowy.

Wklej jeden prompt do Claude Code, Codex, Cursor, Gemini CLI lub OpenClaw. Agent przeczyta nasz skill, zainstaluje go, zaloguje cię kodem, który zatwierdzasz, i zrobi głowę MetaHuman z twojego zdjęcia. Bez kopiowania klucza. Po około 4 minutach GLB i MetaHuman ZIP leżą w twoim folderze.

Domyślny prompt
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.

Zmień ./photo.jpg na ścieżkę do swojego zdjęcia. Resztę zostaw po angielsku: agent potrzebuje adresu URL dokładnie w tej postaci.

  • 0,01 USD za kredyt, płatność za użycie
  • 1500 kredytów na głowę, wszystkie pliki w cenie
  • Skill pyta, zanim cokolwiek wyda
Trzy momenty uruchomienia
  1. Twój agent wypisuje kod, na przykład WXYZ-2345, i link faceninja.net/device.

  2. Otwierasz /device po zalogowaniu, sprawdzasz kod i naciskasz Zatwierdź.

  3. Twój agent podaje koszt i twoje saldo, po czym zapisuje GLB i MetaHuman ZIP.

Konto, prompt, kod.

  1. Załóż konto.

    Załóż konto na faceninja.net przez Google lub e-mail i kup kredyty na głowy, które planujesz. Skill podaje koszt, zanim cokolwiek wyda.

    Załóż konto

  2. Wklej prompt.

    Otwórz agenta w folderze ze swoim zdjęciem i wklej powyższy prompt. Agent pobiera SKILL.md, instaluje skill i uruchamia jego CLI.

  3. Zatwierdź kod.

    Agent pokazuje ci krótki kod. Otwórz faceninja.net/device po zalogowaniu, sprawdź, czy kod się zgadza, i zatwierdź go. Agent działa dalej sam.

Nigdy nie kopiujesz klucza. Jeśli wolisz go używać, utwórz klucz API w aplikacji webowej i ustaw go jako FACENINJA_API_KEY; skill go użyje i pominie kod.

Prompty do prawdziwych zadań.

Każdy prompt podaje adres URL skilla, więc działa w świeżej sesji bez niczego zainstalowanego. Zmień ścieżki na swoje. Prompty zostają po angielsku w każdej wersji językowej tej strony, bo agent musi odczytać adresy URL i nazwy plików dokładnie. Potem nadal możesz rozmawiać z agentem we własnym języku.

01 · Jedna głowa, jedno zdjęcie Domyślny

Twoja pierwsza głowa albo szybki test.

Prompt · angielski
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.

Zostaw ten prompt po angielsku: agent potrzebuje adresu dokładnie w tej postaci. Potem możesz rozmawiać z nim we własnym języku.

02 · Obsada z folderu

Jeden podfolder na osobę, w każdym od 1 do 15 zdjęć.

Prompt · angielski
Read https://faceninja.net/skill/SKILL.md and use the FaceNinja skill. Every subfolder of ./cast is one person: make one MetaHuman head per subfolder from the photos inside it. Before you start, tell me the number of heads, the total cost and my balance, and wait for my yes. Save each head's FBX and MetaHuman ZIP in ./faceninja-out/<subfolder name>.

Obsada licząca więcej niż 5 głów zawsze zatrzymuje się i czeka na twoje „tak”. Skill jest tak zbudowany; prompt tylko to uwidacznia. Zostaw ten prompt po angielsku: agent potrzebuje adresu dokładnie w tej postaci. Potem możesz rozmawiać z nim we własnym języku.

03 · FBX dla już zrobionych głów

Pobierz ponownie w innym formacie. Nic nowego nie powstaje i nic nie jest naliczane.

Prompt · angielski
Use the FaceNinja skill from https://faceninja.net/skill/SKILL.md. List my finished FaceNinja heads, then download each one as FBX with the 52 ARKit blendshapes into ./faceninja-out/fbx, named after the head. Don't create any new heads.

Pliki są dostępne przez 30 dni od zakończenia głowy. Zostaw ten prompt po angielsku: agent potrzebuje adresu dokładnie w tej postaci. Potem możesz rozmawiać z nim we własnym języku.

04 · Pipeline na webhookach

Agent pisze integrację; ty ją przeglądasz i uruchamiasz.

Prompt · angielski
Read https://faceninja.net/llms.txt and https://faceninja.net/skill/SKILL.md. Write a Python script for our pipeline: for each new folder in ./incoming, create one FaceNinja head from its photos with an Idempotency-Key derived from the folder name and a webhook_url I give you. Add a small web handler that checks the FaceNinja-Signature header, and on head.completed downloads the FBX to ./heads/<folder name>; on head.failed it logs error.code. Read the API key from FACENINJA_API_KEY. Don't run anything against my account until I say so.

Zostaw ten prompt po angielsku: agent potrzebuje adresu dokładnie w tej postaci. Potem możesz rozmawiać z nim we własnym języku.

05 · Sprawdź saldo

Przed dużym zadaniem albo gdy uruchomienie się zatrzymało.

Prompt · angielski
Use the FaceNinja skill from https://faceninja.net/skill/SKILL.md to show my FaceNinja balance: the credits I have and how many heads they pay for. Don't spend anything.

Zostaw ten prompt po angielsku: agent potrzebuje adresu dokładnie w tej postaci. Potem możesz rozmawiać z nim we własnym języku.

Gdzie to wkleić.

Ten sam prompt działa w każdym z nich. Różni się tylko miejsce, w które go wklejasz.

Otwórz terminal w folderze projektu, uruchom claude i wklej prompt.

Prompt · angielski
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.

Zostaw ten prompt po angielsku: agent potrzebuje adresu dokładnie w tej postaci. Potem możesz rozmawiać z nim we własnym języku.

Albo najpierw zainstaluj skill dla tego agenta, a potem poproś:

Prompt · angielski
Install the FaceNinja skill with `curl -fsSL https://faceninja.net/skill/install.sh | sh -s -- --claude`, then read the SKILL.md it installed and follow it: sign me in (show me the code to approve) and make a MetaHuman head from ./photo.jpg. Save the GLB and the MetaHuman ZIP in ./faceninja-out.

Instaluje się w ~/.claude/skills/faceninja (lub $CLAUDE_CONFIG_DIR/skills). Nowe sesje ładują go same.

Claude Code, Codex, Cursor, Gemini CLI i OpenClaw są znakami towarowymi ich właścicieli. FaceNinja nie ma z nimi powiązań.

Albo najpierw zainstaluj skill.

Najszybciej poprosić agenta o przeczytanie SKILL.md. Jeśli wolisz zainstalować skill samodzielnie albo twój agent nie potrafi pobierać adresów URL, użyj jednej z tych opcji.

macOS i Linux

Shell
curl -fsSL https://faceninja.net/skill/install.sh | sh

Windows (PowerShell)

PowerShell
irm https://faceninja.net/skill/install.ps1 | iex

ZIP

Pobierz skill i rozpakuj go tam, gdzie twój agent trzyma skille.

Pobierz ZIP

Przeczytaj najpierw

SKILL.md to zwykły tekst. Przeczytaj go albo poproś agenta o streszczenie, zanim cokolwiek uruchomisz.

Pokaż SKILL.md

Przeczytaj skrypt, zanim przekażesz go do powłoki. Oba instalatory są krótkie; otwórz install.sh EN lub install.ps1 EN, by zobaczyć, co robią.

Czego potrzebujesz: Pythona 3 dla CLI, które jest jednym plikiem bez zależności, oraz połączenia z internetem. Nic więcej nie jest instalowane.

Dla agentów, które czytają tylko sieć: https://faceninja.net/llms.txt wymienia dokumentację, plik OpenAPI i skill w formie, którą dobrze czytają modele językowe.

O co agent może poprosić.

Skill to cienka warstwa nad API FaceNinja. Twój agent może robić to, co API, z wbudowanymi poniższymi kontrolami.

Zalogować cię

Kodem zatwierdzanym na faceninja.net/device albo przez FACENINJA_API_KEY.

Robić głowy

Z 1 do 15 zdjęć każdej osoby: jedna głowa albo cały folder osób.

Czekać na nie

Głowa powstaje około 4 minut. Skill czeka, aż będzie gotowa albo się nie uda.

Pobierać dowolny format

GLB, FBX, OBJ, STL, PLY albo MetaHuman ZIP, z 52 kształtami ARKit lub bez.

Pobierać wcześniejsze głowy

Inny format głowy, którą już masz, dopóki jej pliki są przechowywane (30 dni).

Pokazać saldo

Pozostałe kredyty i na ile głów starczą.

Każda głowa zrobiona przez skill to pełna głowa FaceNinja: mapy skóry 4K, rekomendacje groomów (włosów MetaHuman), dopasowana szyja i 52 kształty ARKit. Co zawiera głowa

Pyta, zanim wyda kredyty.

  • Najpierw koszt. Przed każdą głową skill mówi, ile kosztuje i ile zostaje na twoim saldzie.
  • Partie czekają na „tak”. Przy więcej niż 5 głowach naraz skill się zatrzymuje i pyta.
  • Nieudane głowy są zwracane. Jeśli głowa się nie uda, jej 1500 kredytów wraca na twoje saldo samoczynnie, a błąd podaje powód.
  • Żadnego klucza w czacie. Logowanie kodem daje skillowi dostęp bez pojawienia się klucza w twoim prompcie czy historii. Każde nowe logowanie zatwierdzasz osobiście.
  • Ty wyznaczasz pułap. Skill może wydać tylko kupione przez ciebie kredyty. Nie ma subskrypcji ani niczego do anulowania.
  • Zdjęcia są usuwane po 30 dniach. CLI wysyła je z twojego dysku do FaceNinja. To, czy agent też je ogląda, zależy od agenta i twojego promptu.
  • Tylko twarze, które się zgodziły. Używaj zdjęć własnych albo dorosłych osób, które się zgodziły. Żadnych dzieci, żadnych zdjęć z internetu. Dopuszczalne użycie EN

Pytania o agentów.

01Czy potrzebuję klucza API?
Nie. Agent pokazuje ci kod, a ty zatwierdzasz go na faceninja.net/device. Jeśli twoje środowisko nie potrafi pokazać kodu, na przykład zadanie na serwerze, utwórz klucz API w aplikacji webowej i ustaw FACENINJA_API_KEY.
02Z którymi agentami to działa?
Z Claude Code, Codex, Cursor, Gemini CLI i OpenClaw oraz z każdym agentem, który potrafi uruchomić polecenie powłoki lub pobrać adres URL.
03Ile kosztuje skill?
Nic. Głowa kosztuje 1500 kredytów (15 USD), tyle samo co w aplikacji webowej i w API.
04Czy mogę napisać prompt we własnym języku?
Tak, wokół adresów URL. Zostaw https://faceninja.net/skill/SKILL.md i ścieżki do plików dokładnie takie, jakie są, a resztę agent zrozumie w każdym języku, który zna.
05Czy agent może zbudować cały pipeline?
Tak. Prompt 4 powyżej prosi go o napisanie takiego z webhookami i kluczami idempotentności. Stronę Programiści i dokumentację API EN napisaliśmy tak, by agent mógł je czytać.
06Czy jest serwer MCP?
Dziś nie. Skill i llms.txt obejmują wymienionych wyżej agentów. Napisz do nas, jeśli twój agent rozumie tylko MCP.
07Czy agent widzi moje zdjęcia?
CLI skilla wysyła je prosto z twojego dysku. Agent widzi nazwy plików i wyniki. Jeśli poprosisz go o obejrzenie zdjęcia, zrobi to przez własnego dostawcę.
08Dokąd trafiają pliki?
Tam, gdzie wskazuje twój prompt. Domyślny prompt używa ./faceninja-out.

Co dalej.

API

Webhooki, klucze idempotentności i partie, gdy pipeline działa bez agenta.

Programiści

Dokumentacja

Każdy endpoint, pole i błąd oraz plik OpenAPI 3.1.

Dokumentacja API EN

Jedna głowa, bez kodu

Zamiast tego wrzuć zdjęcie w przeglądarce.

Otwórz aplikację

Jeden prompt. Jedna gotowa głowa.

Załóż konto