FaceNinja

Útmutató · Claude Code · Codex · Cursor · Gemini CLI · OpenClaw

Készíts 3D-fejeket Claude Code-dal, Codexszel vagy Cursorral.

A kódoló AI-ügynököd MetaHuman-fejeket készíthet neked: egy fejet egy fotóból, szereplőgárdát egy mappából, FBX-fájlokat minden meglévő fejedhez, vagy szkriptet a pipeline-odhoz. Ez az útmutató végigvezet az első futtatáson, megmutatja, mit kérdez az ügynök, és mire képes, mire nem.

Az első futtatás, lépésről lépésre

  1. Illessz be egy promptot

    Nyisd meg az ügynöködet abban a mappában, ahol a fotód van, és illeszd be ezt. Bármely ügynökben működik, amely tud shellparancsot futtatni vagy URL-t letölteni; az ügynökök oldalán mindegyikhez van változat.

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

    Hagyd angolul ezt a promptot: az ügynöknek pontosan így kell megkapnia a webcímet. Utána a saját nyelveden beszélhetsz vele.

  2. Hagyd jóvá a belépési kódot

    Az ügynök mutat egy rövid kódot, és megnyitja a faceninja.net/device oldalt. Ott belépsz, és jóváhagyod a kódot. API-kulcs nem kerül a chatbe; a skill a kulcsát a számítógépeden tartja, és soha nem írja ki.

  3. Erősítsd meg, hogy használhatod a fotókat

    Az első fej előtt az ügynök mutat egy nyilatkozatot, amelyet a saját szavaiddal kell megerősítened: jogod van a fotók használatához, és minden érintett beleegyezett, mindannyian felnőttek, és betartod a Tartalom- és képmásszabályzatot EN. Az ügynök soha nem erősíti meg helyetted.

  4. Az ügynök előbb megmondja az árat

    Ellenőrzi az egyenlegedet, és megmondja, mennyibe kerül egy fej és mennyi marad, mielőtt bármit elköltene. Öt fejnél több esetén megáll, és megkér, hogy erősítsd meg a végösszeget.

  5. Próbáld ki az ingyenes mintákat

    Az ügynök kredit nélkül is letöltheti a 20 mintafejet, így előbb a pipeline többi részét tesztelheted.

  6. Egy fej, aztán egy mappa

    Szereplőgárdához tedd minden személy fotóit külön almappába, és illeszd be a szereplőgárda-promptot. Az ügynök megszámolja a fejeket, közli a végösszeget, és megvárja az igenedet.

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

    Hagyd angolul ezt a promptot: az ügynöknek pontosan így kell megkapnia a webcímet. Utána a saját nyelveden beszélhetsz vele.

Mit futtat a skill

A skill egyetlen Python-fájl, telepítendő csomagok nélkül (Python 3.9 vagy újabb). Az ügynököd futtatja; te is futtathatod. Ez a saját súgója, szerkesztés nélkül:

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

Mit tud és mit nem tud az ügynök

  • Fejeket készíteni egy személy 1–15 fotójából, almappánként egy fejet, és letölteni a GLB, FBX, OBJ, STL vagy PLY fájlt, illetve a MetaHuman ZIP-et.
  • Ellenőrizni az egyenlegedet, listázni a fejeidet, és újra letölteni őket.
  • Pipeline-szkriptet írni idempotencia-kulcsokkal és webhookkezelővel, az llms.txt és a skill alapján.
  • Krediteket vásárolni vagy automatikus feltöltést bekapcsolni: ehelyett a webalkalmazásba küld.
  • Helyetted megerősíteni a beleegyezést vagy jóváhagyni egy belépést.
  • Fejet készíteni gyerekekről, közszereplőkről vagy netről származó fotókból.

Kérdések az AI-ügynökökkel készült fejekről

01Mely ügynökök működnek?
A Claude Code, a Codex, a Cursor, a Gemini CLI és az OpenClaw, valamint bármely ügynök, amely tud shellparancsot futtatni vagy URL-t letölteni.
02API-kulcsot kell beillesztenem a chatbe?
Nem. A böngésződben jóváhagysz egy kódot, a skill pedig a számítógépeden tartja a kulcsot. Soha nem írja ki.
03Költhet az ügynök kérdezés nélkül?
Minden feladat előtt közli a költséget és az egyenlegedet, öt fej felett pedig megáll, és a megerősítésedre vár.
04Van MCP-szerver?
Jelenleg nincs. A skill egy parancssori szkripten keresztül működik, amelyet az ügynökök közvetlenül futtatnak.

Készíts MetaHumant a saját fotódból.

Regisztrálj ingyen, töltsd le a mintafejeket, és készíts fejeket a saját fotóidból, amikor indulnak a fizetős csomagok.