FaceNinja

AI-agents · Claude Code, Codex, Cursor, Gemini CLI, OpenClaw

Je AI-agent kan de hoofden maken.

Plak één prompt in Claude Code, Codex, Cursor, Gemini CLI of OpenClaw. Je agent leest onze skill, installeert die, logt je in met een code die jij goedkeurt en maakt een MetaHuman-hoofd van je foto. Geen key om te kopiëren. Ongeveer 4 minuten later staan de GLB en de MetaHuman ZIP in je map.

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

Vervang ./photo.jpg door het pad naar je foto. Laat de rest in het Engels: de agent heeft de URL precies zo nodig als hij er staat.

  • US$ 0,01 per credit, betaal wat je gebruikt
  • 1.500 credits per hoofd, elk bestand inbegrepen
  • De skill vraagt eerst, vóór hij iets uitgeeft
Drie momenten van een run
  1. Je agent toont een code zoals WXYZ-2345 en de link faceninja.net/device.

  2. Je opent /device terwijl je bent ingelogd, controleert de code en drukt op Goedkeuren.

  3. Je agent noemt de kosten en je saldo en slaat daarna de GLB en de MetaHuman ZIP op.

Account, prompt, code.

  1. Maak een account.

    Maak op faceninja.net een account met Google of je e-mailadres en koop de credits voor de hoofden die je van plan bent te maken. De skill noemt de kosten voordat hij iets uitgeeft.

    Account aanmaken

  2. Plak de prompt.

    Open je agent in de map met je foto en plak de prompt hierboven. De agent haalt SKILL.md op, installeert de skill en draait de bijbehorende CLI.

  3. Keur de code goed.

    De agent toont je een korte code. Open faceninja.net/device terwijl je bent ingelogd, controleer of de code klopt en keur hem goed. De agent gaat daarna zelf verder.

Je kopieert nooit een key. Wil je er liever een gebruiken, maak dan in de webapp een API-key aan en stel die in als FACENINJA_API_KEY; de skill gebruikt die en slaat de code over.

Prompts voor echte klussen.

Elke prompt noemt de URL van de skill, dus hij werkt in een verse sessie waarin niets is geïnstalleerd. Pas de paden aan naar de jouwe. De prompts blijven in elke taalversie van deze site in het Engels, omdat de agent de URL's en bestandsnamen precies moet lezen. Daarna kun je nog steeds in je eigen taal met je agent praten.

01 · Eén hoofd uit één foto Standaard

Je eerste hoofd, of een snelle test.

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

02 · Een cast uit een map

Eén submap per persoon, met 1 tot 15 foto's in elke.

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

Een cast van meer dan 5 hoofden wacht altijd op jouw ja. De skill is zo gebouwd; de prompt maakt dat alleen expliciet. 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.

03 · FBX voor al gemaakte hoofden

Download opnieuw in een ander formaat. Er wordt niets nieuws gemaakt of in rekening gebracht.

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

Bestanden blijven 30 dagen beschikbaar nadat een hoofd klaar is. 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.

04 · Een webhook-pipelinescript

Je agent schrijft de integratie; jij bekijkt hem en voert hem uit.

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

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.

05 · Saldo controleren

Voor een grote klus, of als een run is gestopt.

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

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.

Waar je het plakt.

Dezelfde prompt werkt in elk daarvan. Alleen de plek waar je hem plakt verschilt.

Open een terminal in je projectmap, voer claude uit en plak de prompt.

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

Of installeer eerst de skill voor deze agent en vraag dan:

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

Wordt geïnstalleerd in ~/.claude/skills/faceninja (of $CLAUDE_CONFIG_DIR/skills). Nieuwe sessies laden hem vanzelf.

Claude Code, Codex, Cursor, Gemini CLI en OpenClaw zijn handelsmerken van hun eigenaren. FaceNinja is niet met hen verbonden.

Of installeer eerst de skill.

Je agent SKILL.md laten lezen is de snelste manier. Installeer je de skill liever zelf, of kan je agent geen URL's ophalen, gebruik dan een van deze.

macOS en Linux

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

Windows (PowerShell)

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

ZIP

Download de skill en pak hem uit waar je agent zijn skills bewaart.

Download ZIP

Eerst lezen

SKILL.md is gewone tekst. Lees het, of vraag je agent het samen te vatten, voordat je iets uitvoert.

Open SKILL.md

Lees een script voordat je het in een shell pipet. Beide installers zijn kort; open install.sh EN of install.ps1 EN om te zien wat ze doen.

Wat je nodig hebt: Python 3 voor de CLI, die uit één bestand zonder dependencies bestaat, en een internetverbinding. Er wordt verder niets geïnstalleerd.

Voor agents die alleen het web lezen: https://faceninja.net/llms.txt somt de documentatie, het OpenAPI-bestand en de skill op in een vorm die taalmodellen goed lezen.

Wat je agent kan vragen.

De skill is een dunne laag over de FaceNinja-API. Je agent kan alles wat de API kan, met de onderstaande controles ingebouwd.

Jou inloggen

Met een code die je goedkeurt op faceninja.net/device, of met FACENINJA_API_KEY.

Hoofden maken

Uit 1 tot 15 foto's van elk één persoon, één hoofd of een hele map vol mensen.

Erop wachten

Een hoofd duurt ongeveer 4 minuten. De skill wacht tot het klaar is of is mislukt.

Elk formaat downloaden

GLB, FBX, OBJ, STL, PLY of de MetaHuman ZIP, met of zonder de 52 ARKit-blendshapes.

Eerdere hoofden ophalen

Download een ander formaat van een hoofd dat je al hebt gemaakt, zolang de bestanden worden bewaard (30 dagen).

Je saldo tonen

Resterende credits en hoeveel hoofden je daarmee kunt betalen.

Elk hoofd dat de skill maakt is een volledig FaceNinja-hoofd: 4K-huidmaps, aanbevelingen voor grooms (MetaHuman-haar), een passende nek en 52 ARKit-blendshapes. Wat zit er in een hoofd

Eerst vragen, dan uitgeven.

  • Eerst de kosten. Vóór elk hoofd zegt de skill wat het kost en wat er op je saldo overblijft.
  • Batches wachten op een ja. Meer dan 5 hoofden tegelijk, en de skill stopt en vraagt het eerst.
  • Mislukte hoofden worden terugbetaald. Als een hoofd mislukt, komen de 1.500 credits vanzelf terug op je saldo, en de foutmelding zegt waarom.
  • Geen key in je chat. Met inloggen via een code krijgt de skill toegang zonder dat er ooit een key in je prompt of je geschiedenis staat. Elke nieuwe login keur je zelf goed.
  • Jij bepaalt het plafond. De skill kan alleen credits uitgeven die je hebt gekocht. Er is geen abonnement en niets om op te zeggen.
  • Foto's worden na 30 dagen verwijderd. De CLI uploadt ze van je schijf naar FaceNinja. Of je agent ze ook zelf bekijkt, hangt af van de agent en je prompt.
  • Alleen gezichten die ja hebben gezegd. Gebruik foto's van jezelf of van volwassenen die hebben ingestemd. Geen kinderen, geen foto's van internet. Toegestaan gebruik EN

Vragen over agents.

01Heb ik een API-key nodig?
Nee. De agent toont je een code en die keur je goed op faceninja.net/device. Kan jouw opzet geen code tonen, bijvoorbeeld een serverjob, maak dan in de webapp een API-key aan en stel FACENINJA_API_KEY in.
02Met welke agents werkt het?
Claude Code, Codex, Cursor, Gemini CLI en OpenClaw, en elke agent die een shell-opdracht kan uitvoeren of een URL kan ophalen.
03Wat kost de skill?
Niets. Een hoofd kost 1.500 credits (US$ 15), net als in de webapp en de API.
04Kan ik de prompt in mijn eigen taal schrijven?
Ja, rond de URL's. Laat https://faceninja.net/skill/SKILL.md en je bestandspaden precies zoals ze zijn, dan volgt de agent de rest in elke taal die hij begrijpt.
05Kan mijn agent een hele pipeline bouwen?
Ja. Prompt 4 hierboven vraagt om er een te schrijven met webhooks en idempotency-keys. De pagina Developers en de API-referentie EN zijn zo geschreven dat ook een agent ze kan lezen.
06Is er een MCP-server?
Nu niet. De skill en llms.txt dekken de hierboven genoemde agents. Schrijf ons als jouw agent alleen MCP spreekt.
07Ziet de agent mijn foto's?
De CLI van de skill uploadt ze rechtstreeks van je schijf. Je agent ziet de bestandsnamen en de resultaten. Als je hem vraagt een foto te bekijken, doet hij dat, via zijn eigen provider.
08Waar komen de bestanden terecht?
Waar je prompt dat zegt. De standaardprompt gebruikt ./faceninja-out.

Verder gaan.

De API

Webhooks, idempotency-keys en batches, voor als de pipeline zonder agent draait.

Developers

De referentie

Elk endpoint, veld en elke fout, plus een OpenAPI 3.1-bestand.

API-referentie EN

Eén hoofd, zonder code

Upload in plaats daarvan een foto in de browser.

Open de webapp

Eén prompt. Eén afgewerkt hoofd.

Account aanmaken