FaceNinja

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

Lag 3D-hoder fra Claude Code, Codex eller Cursor.

AI-kodeagenten din kan lage MetaHuman-hoder for deg: ett hode fra et foto, et rollegalleri fra en mappe, FBX-filer for alle hodene du har, eller et skript til pipelinen din. Denne veiledningen går gjennom den første kjøringen, hva agenten spør deg om, og hva den kan og ikke kan gjøre.

Den første kjøringen, trinn for trinn

  1. Lim inn én prompt

    Åpne agenten din i mappen med fotoet ditt og lim inn dette. Det fungerer i alle agenter som kan kjøre en shell-kommando eller hente en URL; siden om AI-agenter har en versjon for hver av 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.

    La prompten stå på engelsk: agenten din trenger nettadressen nøyaktig slik den er skrevet. Etterpå kan du snakke med den på ditt eget språk.

  2. Godkjenn innloggingskoden

    Agenten viser deg en kort kode og åpner faceninja.net/device. Der logger du inn og godkjenner koden. Ingen API-nøkkel limes inn i chatten; skillen beholder nøkkelen på datamaskinen din og skriver den aldri ut.

  3. Bekreft at du har rett til å bruke fotoene

    Før det første hodet viser agenten deg en erklæring som du bekrefter med egne ord: at du har rett til å bruke fotoene og samtykke fra hver person, at de er voksne, og at du følger retningslinjene for innhold og avbildning av personer EN. Agenten bekrefter det aldri for deg.

  4. Agenten oppgir kostnaden først

    Den sjekker saldoen din og forteller deg hva et hode koster og hva som blir igjen, før den bruker noe. For mer enn fem hoder stopper den og ber deg bekrefte totalen.

  5. Prøv de gratis eksemplene

    Uten noen kreditter i det hele tatt kan agenten laste ned de 20 eksempelhodene, så du kan teste resten av pipelinen din først.

  6. Ett hode, så en mappe

    For et rollegalleri legger du fotoene av hver person i en egen undermappe og limer inn cast-prompten. Agenten teller hodene, oppgir totalen og venter på ditt 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>.

    La prompten stå på engelsk: agenten din trenger nettadressen nøyaktig slik den er skrevet. Etterpå kan du snakke med den på ditt eget språk.

Hva skillen kjører

Skillen er én Python-fil uten pakker å installere (Python 3.9 eller nyere). Agenten din kjører den; du kan kjøre den selv også. Dette er dens egen hjelpetekst, uredigert:

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

Hva agenten kan og ikke kan gjøre

  • Lage hoder fra 1–15 foto av én person, ett hode per undermappe, og laste ned GLB, FBX, OBJ, STL, PLY eller MetaHuman ZIP.
  • Sjekke saldoen din, liste opp hodene dine og laste dem ned på nytt.
  • Skrive et pipelineskript med idempotency-nøkler og en webhook-håndterer, ut fra llms.txt og skillen.
  • Kjøpe kreditter eller slå på automatisk påfylling: den sender deg til nettappen i stedet.
  • Bekrefte samtykke eller godkjenne en innlogging for deg.
  • Lage hoder av barn, av offentlige personer, eller fra foto funnet på internett.

Spørsmål om hoder fra AI-agenter

01Hvilke agenter fungerer?
Claude Code, Codex, Cursor, Gemini CLI og OpenClaw, og alle agenter som kan kjøre en shell-kommando eller hente en URL.
02Limer jeg inn en API-nøkkel i chatten?
Nei. Du godkjenner en kode i nettleseren, og skillen beholder nøkkelen på datamaskinen din. Den skriver den aldri ut.
03Kan agenten bruke kreditter uten å spørre?
Den forteller deg kostnaden og saldoen din før hver jobb, og stopper for bekreftelse ved mer enn fem hoder.
04Finnes det en MCP-server?
Ikke i dag. Skillen fungerer gjennom et kommandolinjeskript som agentene kjører direkte.

Lag en MetaHuman fra ditt eget foto.

Registrer deg gratis, last ned eksempelhodene, og lag hoder fra dine egne foto når betalte planer åpner.