Gör 3D-huvuden från Claude Code, Codex eller Cursor.

Den första körningen, steg för steg

1. Klistra in en prompt

   Öppna din agent i mappen med ditt foto och klistra in det här. Det fungerar i alla agenter som kan köra ett skalkommando eller hämta en URL; sidan om AI-agenter har en version för var och en.

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

   Låt prompten vara på engelska: din agent behöver webbadressen exakt som den står. Sedan kan du prata med den på ditt eget språk.

2. Godkänn inloggningskoden

   Agenten visar en kort kod och öppnar faceninja.net/device. Där loggar du in och godkänner koden. Ingen API-nyckel klistras in i chatten; skillen sparar sin nyckel på din dator och skriver aldrig ut den.

3. Bekräfta att du får använda fotona

   Före det första huvudet visar agenten ett påstående som du bekräftar med egna ord: du har rätt att använda fotona och samtycke från varje person, de är vuxna, och du följer Policy för innehåll och avbildning av personer EN. Agenten bekräftar det aldrig åt dig.

4. Agenten anger kostnaden först

   Den kontrollerar ditt saldo och berättar vad ett huvud kostar och vad som blir kvar innan den spenderar något. För fler än fem huvuden stannar den och ber dig bekräfta totalen.

5. Prova de gratis exemplen

   Även helt utan krediter kan agenten ladda ner de 20 exempelhuvudena, så att du kan testa resten av din pipeline först.

6. Ett huvud, sedan en mapp

   För en ensemble lägger du varje persons foton i en egen undermapp och klistrar in ensembleprompten. Agenten räknar huvudena, anger totalen och väntar på ditt ja.

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

   Låt prompten vara på engelska: din agent behöver webbadressen exakt som den står. Sedan kan du prata med den på ditt eget språk.

Vad skillen kör

Skillen är en enda Python-fil utan paket att installera (Python 3.9 eller senare). Din agent kör den; det kan du också göra. Det här är dess egen hjälptext, oredigerad:

$ 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

Vad agenten kan och inte kan göra

• Göra huvuden från 1–15 foton av en person, ett huvud per undermapp, och ladda ner GLB, FBX, OBJ, STL, PLY eller MetaHuman ZIP.
• Kontrollera ditt saldo, lista dina huvuden och ladda ner dem igen.
• Skriva ett pipelineskript med idempotensnycklar och en webhook-hanterare, utifrån llms.txt och skillen.

• Köpa krediter eller slå på automatisk påfyllning: den skickar dig till webbappen i stället.
• Bekräfta samtycke eller godkänna en inloggning åt dig.
• Göra huvuden av barn, av offentliga personer eller från foton som hittats på nätet.

Frågor om huvuden från AI-agenter

01Vilka agenter fungerar?

Claude Code, Codex, Cursor, Gemini CLI och OpenClaw, och alla agenter som kan köra ett skalkommando eller hämta en URL.

02Klistrar jag in en API-nyckel i chatten?

Nej. Du godkänner en kod i webbläsaren, och skillen sparar nyckeln på din dator. Den skriver aldrig ut den.

03Kan agenten spendera utan att fråga?

Den anger kostnaden och ditt saldo före varje jobb, och stannar för din bekräftelse vid fler än fem huvuden.

04Finns det en MCP-server?

Inte i dag. Skillen fungerar via ett kommandoradsskript som agenter kör direkt.