Twórz głowy 3D z Claude Code, Codex lub Cursor.

Pierwsze uruchomienie krok po kroku

1. Wklej jeden prompt

   Otwórz agenta w folderze ze zdjęciem i wklej to. Działa w każdym agencie, który potrafi uruchomić polecenie powłoki lub pobrać URL; strona o agentach ma wersję dla każdego z nich.

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

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

2. Zatwierdź kod logowania

   Agent pokazuje krótki kod i otwiera faceninja.net/device. Tam logujesz się i zatwierdzasz kod. Żaden klucz API nie trafia do czatu; skill trzyma swój klucz na twoim komputerze i nigdy go nie wypisuje.

3. Potwierdź, że możesz użyć zdjęć

   Przed pierwszą głową agent pokazuje oświadczenie do potwierdzenia własnymi słowami: masz prawo użyć zdjęć i zgodę każdej osoby, są to osoby dorosłe i przestrzegasz Zasad dotyczących treści i wizerunku EN. Agent nigdy nie potwierdza tego za ciebie.

4. Agent najpierw podaje koszt

   Sprawdza twoje saldo i mówi, ile kosztuje głowa i ile zostanie, zanim cokolwiek wyda. Przy ponad pięciu głowach zatrzymuje się i prosi o potwierdzenie łącznej kwoty.

5. Wypróbuj darmowe przykłady

   Nawet bez żadnych kredytów agent może pobrać 20 przykładowych głów, więc najpierw przetestujesz resztę pipeline’u.

6. Najpierw jedna głowa, potem folder

   Dla obsady umieść zdjęcia każdej osoby w osobnym podfolderze i wklej prompt dla obsady. Agent liczy głowy, podaje łączną kwotę i czeka na twoje „tak”.

   Prompt · angielskiKopiuj prompt

   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>.

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

Co uruchamia skill

Skill to jeden plik Pythona bez pakietów do instalowania (Python 3.9 lub nowszy). Uruchamia go twój agent; ty też możesz. To jego własna pomoc, bez zmian:

$ python3 faceninja.py --help
usage: faceninja.py [-h] [--json] [--base BASE] [--version] COMMAND ...

FaceNinja: photos in, MetaHuman head out.

positional arguments:
  COMMAND
    login      sign in by approving a code in the browser
    whoami     who is signed in
    balance    credits left and what a head costs
    make       make one head from 1-15 photos of one person
    status     where a head stands
    download   download a finished head's files
    batch      one head per photo, or per subfolder with --per-person-
               subfolders
    samples    the free sample heads: list them, or --download ID|all (no
               credits)
    list       your heads, newest first
    logout     revoke and forget the saved key
    update     update the skill now (it also updates itself at most hourly)
    guidance   the server's current rules and notices for agents
    attest     the user confirms, once per computer, that they may use the
               photos (asked before the first head)

options:
  -h, --help   show this help message and exit
  --json       one JSON object on stdout, progress on stderr
  --base BASE  API server (default $FACENINJA_API_BASE or
               https://faceninja.net)
  --version    show program's version number and exit

Co agent może, a czego nie może zrobić

• Robić głowy z 1–15 zdjęć jednej osoby, jedna głowa na podfolder, i pobierać GLB, FBX, OBJ, STL, PLY lub MetaHuman ZIP.
• Sprawdzać twoje saldo, wyświetlać listę twoich głów i pobierać je ponownie.
• Napisać skrypt pipeline’u z kluczami idempotencji i obsługą webhooków, na podstawie llms.txt i skilla.

• Kupować kredytów ani włączać automatycznego doładowania: zamiast tego odsyła cię do aplikacji webowej.
• Potwierdzać zgody ani zatwierdzać logowania za ciebie.
• Robić głów dzieci, osób publicznych ani ze zdjęć znalezionych w internecie.

Pytania o głowy z agentów AI

01Które agenty działają?

Claude Code, Codex, Cursor, Gemini CLI i OpenClaw oraz każdy agent, który potrafi uruchomić polecenie powłoki lub pobrać URL.

02Czy wklejam klucz API do czatu?

Nie. Zatwierdzasz kod w przeglądarce, a skill trzyma klucz na twoim komputerze. Nigdy go nie wypisuje.

03Czy agent może wydawać bez pytania?

Przed każdym zadaniem podaje koszt i twoje saldo, a powyżej pięciu głów zatrzymuje się i czeka na twoje potwierdzenie.

04Czy jest serwer MCP?

Na razie nie. Skill działa przez skrypt wiersza poleceń, który agenci uruchamiają bezpośrednio.