Maak 3D-hoofden vanuit Claude Code, Codex of Cursor.

De eerste run, stap voor stap

1. Plak één prompt

   Open je agent in de map met je foto en plak dit. Het werkt in elke agent die een shellcommando kan uitvoeren of een URL kan ophalen; de pagina over AI-agents heeft een versie voor elke agent.

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

   Laat deze prompt in het Engels: je agent heeft het webadres precies zo nodig als het er staat. Daarna kun je er in je eigen taal mee praten.

2. Keur de inlogcode goed

   De agent toont je een korte code en opent faceninja.net/device. Daar log je in en keur je de code goed. Er wordt geen API-key in de chat geplakt; de skill bewaart zijn key op je computer en toont hem nooit.

3. Bevestig dat je de foto's mag gebruiken

   Voor het eerste hoofd toont de agent je een verklaring die je in je eigen woorden bevestigt: je hebt het recht om de foto's te gebruiken en de toestemming van elke persoon, ze zijn volwassen, en je volgt het Beleid voor content en portretrecht EN. De agent bevestigt dit nooit voor jou.

4. De agent noemt eerst de kosten

   Hij controleert je saldo en vertelt je wat een hoofd kost en wat er overblijft voordat hij iets uitgeeft. Bij meer dan vijf hoofden stopt hij en vraagt hij je het totaal te bevestigen.

5. Probeer de gratis voorbeelden

   Ook zonder credits kan de agent de 20 voorbeeldhoofden downloaden, zodat je eerst de rest van je pipeline kunt testen.

6. Eén hoofd, dan een map

   Zet voor een cast de foto's van elke persoon in een eigen submap en plak de castprompt. De agent telt de hoofden, noemt het totaal en wacht op je ja.

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

   Laat deze prompt in het Engels: je agent heeft het webadres precies zo nodig als het er staat. Daarna kun je er in je eigen taal mee praten.

Wat de skill uitvoert

De skill is één Python-bestand zonder pakketten om te installeren (Python 3.9 of nieuwer). Je agent voert het uit; jij kunt dat ook. Dit is de eigen help ervan, onbewerkt:

$ 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

Wat de agent wel en niet kan

• Hoofden maken van 1–15 foto's van één persoon, één hoofd per submap, en GLB, FBX, OBJ, STL, PLY of de MetaHuman ZIP downloaden.
• Je saldo controleren, je hoofden opsommen en ze opnieuw downloaden.
• Een pipelinescript schrijven met idempotency-keys en een webhookhandler, op basis van llms.txt en de skill.

• Credits kopen of automatisch opwaarderen aanzetten: daarvoor stuurt hij je naar de webapp.
• Toestemming bevestigen of een inlog goedkeuren namens jou.
• Hoofden maken van kinderen, van publieke figuren of van foto's die online zijn gevonden.

Vragen over hoofden via AI-agents

01Welke agents werken?

Claude Code, Codex, Cursor, Gemini CLI en OpenClaw, en elke agent die een shellcommando kan uitvoeren of een URL kan ophalen.

02Plak ik een API-key in de chat?

Nee. Je keurt een code goed in je browser, en de skill bewaart de key op je computer. Hij toont hem nooit.

03Kan de agent geld uitgeven zonder te vragen?

Hij noemt de kosten en je saldo voor elke opdracht, en stopt boven vijf hoofden voor je bevestiging.

04Is er een MCP-server?

Vandaag niet. De skill werkt via een commandoregelscript dat agents direct uitvoeren.