FaceNinja

Guide · Claude Code · Codex · Cursor · Gemini CLI · OpenClaw

Lav 3D-hoveder fra Claude Code, Codex eller Cursor.

Din AI-kodeagent kan lave MetaHuman-hoveder for dig: ét hoved fra et foto, et cast fra en mappe, FBX-filer til hvert hoved, du har, eller et script til din pipeline. Denne guide gennemgår den første kørsel, hvad agenten spørger dig om, og hvad den kan og ikke kan.

Den første kørsel, trin for trin

  1. Indsæt én prompt

    Åbn din agent i mappen med dit foto, og indsæt dette. Det virker i enhver agent, der kan køre en shell-kommando eller hente en URL; siden om AI-agenter har en version til hver af dem.

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

    Lad prompten være på engelsk: din agent skal have webadressen præcis, som den står. Bagefter kan du tale med den på dit eget sprog.

  2. Godkend login-koden

    Agenten viser dig en kort kode og åbner faceninja.net/device. Der logger du ind og godkender koden. Der indsættes ingen API-nøgle i chatten; skillen gemmer sin nøgle på din computer og udskriver den aldrig.

  3. Bekræft, at du må bruge fotoene

    Før det første hoved viser agenten dig en erklæring, som du bekræfter med dine egne ord: du har ret til at bruge fotoene og samtykke fra hver person, de er voksne, og du følger Politik for indhold og afbildning af personer EN. Agenten bekræfter det aldrig for dig.

  4. Agenten oplyser prisen først

    Den tjekker din saldo og fortæller dig, hvad et hoved koster, og hvad der er tilbage, før den bruger noget. Ved mere end fem hoveder stopper den og beder dig bekræfte det samlede beløb.

  5. Prøv de gratis eksempler

    Selv helt uden kreditter kan agenten hente de 20 eksempelhoveder, så du kan teste resten af din pipeline først.

  6. Ét hoved, så en mappe

    Til et cast lægger du hver persons fotos i sin egen undermappe og indsætter cast-prompten. Agenten tæller hovederne, oplyser det samlede beløb og venter på dit ja.

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

    Lad prompten være på engelsk: din agent skal have webadressen præcis, som den står. Bagefter kan du tale med den på dit eget sprog.

Hvad skillen kører

Skillen er én Python-fil uden pakker at installere (Python 3.9 eller nyere). Din agent kører den; det kan du også. Her er dens egen hjælpetekst, uredigeret:

Shell
$ 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

Hvad agenten kan og ikke kan

  • Lave hoveder fra 1–15 fotos af én person, ét hoved pr. undermappe, og hente GLB, FBX, OBJ, STL, PLY eller MetaHuman ZIP.
  • Tjekke din saldo, vise dine hoveder og hente dem igen.
  • Skrive et pipeline-script med idempotensnøgler og en webhook-handler ud fra llms.txt og skillen.
  • Købe kreditter eller slå automatisk optankning til: den sender dig til webappen i stedet.
  • Bekræfte samtykke eller godkende et login for dig.
  • Lave hoveder af børn, af offentlige personer eller ud fra fotos fundet på nettet.

Spørgsmål om hoveder fra AI-agenter

01Hvilke agenter virker?
Claude Code, Codex, Cursor, Gemini CLI og OpenClaw samt enhver agent, der kan køre en shell-kommando eller hente en URL.
02Skal jeg indsætte en API-nøgle i chatten?
Nej. Du godkender en kode i din browser, og skillen gemmer nøglen på din computer. Den udskriver den aldrig.
03Kan agenten bruge penge uden at spørge?
Den oplyser prisen og din saldo før hvert job og stopper for at få din bekræftelse ved mere end fem hoveder.
04Findes der en MCP-server?
Ikke i dag. Skillen virker gennem et kommandolinjescript, som agenter kører direkte.

Lav en MetaHuman ud fra dit eget foto.

Tilmeld dig gratis, hent eksempelhovederne, og lav hoveder fra dine egne fotos, når betalte planer åbner.