FaceNinja

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

Creați capete 3D din Claude Code, Codex sau Cursor.

Agentul AI de programare poate crea capete MetaHuman pentru dumneavoastră: un cap dintr-o fotografie, o distribuție dintr-un folder, fișiere FBX pentru fiecare cap pe care îl aveți sau un script pentru pipeline. Acest ghid parcurge prima rulare, ce vă întreabă agentul și ce poate și ce nu poate face.

Prima rulare, pas cu pas

  1. Lipiți un prompt

    Deschideți agentul în folderul cu fotografia și lipiți acest text. Funcționează în orice agent care poate rula o comandă shell sau poate descărca un URL; pagina pentru agenți are o versiune pentru fiecare.

    Prompt · engleză
    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ăsați acest prompt în engleză: agentul are nevoie de adresa web exact așa cum este scrisă. Apoi îi puteți vorbi în limba dumneavoastră.

  2. Aprobați codul de conectare

    Agentul vă arată un cod scurt și deschide faceninja.net/device. Vă conectați acolo și aprobați codul. Nu lipiți nicio cheie API în chat; skill-ul își păstrează cheia pe computerul dumneavoastră și nu o afișează niciodată.

  3. Confirmați că aveți dreptul să folosiți fotografiile

    Înainte de primul cap, agentul vă arată o declarație pe care să o confirmați cu propriile cuvinte: aveți dreptul să folosiți fotografiile și consimțământul fiecărei persoane, persoanele sunt adulte și respectați Politica privind conținutul și dreptul la imagine EN. Agentul nu o confirmă niciodată în locul dumneavoastră.

  4. Agentul spune mai întâi costul

    Vă verifică soldul și vă spune cât costă un cap și cât rămâne, înainte să cheltuiască ceva. Pentru mai mult de cinci capete, se oprește și vă cere să confirmați totalul.

  5. Încercați exemplele gratuite

    Fără niciun credit, agentul poate descărca cele 20 de capete de exemplu, ca să testați mai întâi restul pipeline-ului.

  6. Un cap, apoi un folder

    Pentru o distribuție, puneți fotografiile fiecărei persoane în propriul subfolder și lipiți promptul pentru distribuție. Agentul numără capetele, spune totalul și așteaptă confirmarea dumneavoastră.

    Prompt · engleză
    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ăsați acest prompt în engleză: agentul are nevoie de adresa web exact așa cum este scrisă. Apoi îi puteți vorbi în limba dumneavoastră.

Ce rulează skill-ul

Skill-ul este un singur fișier Python, fără pachete de instalat (Python 3.9 sau mai nou). Agentul îl rulează; îl puteți rula și dumneavoastră. Acesta este propriul lui text de ajutor, needitat:

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

Ce poate și ce nu poate face agentul

  • Să creeze capete din 1–15 fotografii ale unei persoane, câte un cap per subfolder, și să descarce GLB, FBX, OBJ, STL, PLY sau MetaHuman ZIP.
  • Să vă verifice soldul, să vă listeze capetele și să le descarce din nou.
  • Să scrie un script de pipeline cu chei de idempotență și un handler de webhook, pornind de la llms.txt și de la skill.
  • Să cumpere credite sau să activeze reîncărcarea automată: în schimb, vă trimite la aplicația web.
  • Să confirme consimțământul sau să aprobe o conectare în locul dumneavoastră.
  • Să creeze capete ale copiilor, ale persoanelor publice sau din fotografii găsite online.

Întrebări despre capete create de agenți AI

01Ce agenți funcționează?
Claude Code, Codex, Cursor, Gemini CLI și OpenClaw, plus orice agent care poate rula o comandă shell sau poate descărca un URL.
02Trebuie să lipesc o cheie API în chat?
Nu. Aprobați un cod în browser, iar skill-ul păstrează cheia pe computerul dumneavoastră. Nu o afișează niciodată.
03Poate agentul să cheltuiască fără să întrebe?
Vă spune costul și soldul înaintea fiecărei lucrări și se oprește pentru confirmare peste cinci capete.
04Există un server MCP?
Nu deocamdată. Skill-ul funcționează printr-un script de linie de comandă pe care agenții îl rulează direct.

Faceți un MetaHuman din propria fotografie.

Creați un cont gratuit, descărcați capetele de exemplu și faceți capete din propriile fotografii când se deschid planurile plătite.