FaceNinja

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

Tee 3D-päitä Claude Codella, Codexilla tai Cursorilla.

Koodaava tekoälyagenttisi voi tehdä sinulle MetaHuman-päitä: yhden 3D-pään valokuvasta, hahmoston kansiosta, FBX-tiedostot kaikista 3D-päistäsi tai skriptin tuotantoputkeesi. Tämä opas käy läpi ensimmäisen ajon, mitä agentti kysyy sinulta ja mitä se voi ja ei voi tehdä.

Ensimmäinen ajo vaihe vaiheelta

  1. Liitä yksi kehote

    Avaa agenttisi kansiossa, jossa valokuvasi on, ja liitä tämä. Se toimii missä tahansa agentissa, joka osaa ajaa shell-komennon tai hakea URL-osoitteen; agenttisivulla on versio kullekin.

    Kehote · englanti
    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.

    Pidä tämä kehote englanniksi: agenttisi tarvitsee verkko-osoitteen täsmälleen kirjoitetussa muodossa. Sen jälkeen voit puhua sille omalla kielelläsi.

  2. Hyväksy kirjautumiskoodi

    Agentti näyttää lyhyen koodin ja avaa osoitteen faceninja.net/device. Kirjaudut siellä ja hyväksyt koodin. API-avainta ei liitetä keskusteluun; skill säilyttää avaimensa tietokoneellasi eikä koskaan tulosta sitä.

  3. Vahvista, että saat käyttää valokuvia

    Ennen ensimmäistä 3D-päätä agentti näyttää vakuutuksen, joka vahvistetaan omin sanoin: sinulla on oikeus käyttää valokuvia ja jokaisen henkilön suostumus, he ovat aikuisia, ja noudatat Sisältö- ja henkilökuvakäytäntöä EN. Agentti ei koskaan vahvista sitä puolestasi.

  4. Agentti kertoo hinnan ensin

    Se tarkistaa saldosi ja kertoo, mitä 3D-pää maksaa ja paljonko jää, ennen kuin kuluttaa mitään. Yli viiden 3D-pään kohdalla se pysähtyy ja pyytää vahvistamaan kokonaissumman.

  5. Kokeile ilmaisia näytteitä

    Ilman yhtään krediittiä agentti voi ladata 20 näytepäätä, joten voit testata muun tuotantoputkesi ensin.

  6. Ensin yksi 3D-pää, sitten kansio

    Hahmostoa varten laita kunkin henkilön valokuvat omaan alikansioonsa ja liitä hahmoston kehote. Agentti laskee 3D-päät, kertoo kokonaissumman ja odottaa myöntävää vastaustasi.

    Kehote · englanti
    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>.

    Pidä tämä kehote englanniksi: agenttisi tarvitsee verkko-osoitteen täsmälleen kirjoitetussa muodossa. Sen jälkeen voit puhua sille omalla kielelläsi.

Mitä skill ajaa

Skill on yksi Python-tiedosto ilman asennettavia paketteja (Python 3.9 tai uudempi). Agenttisi ajaa sitä; voit ajaa sitä itsekin. Tämä on sen oma ohje muokkaamattomana:

Komentorivi
$ 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ä agentti voi ja ei voi tehdä

  • Tehdä 3D-päitä 1–15 valokuvasta yhdestä henkilöstä, yksi 3D-pää alikansiota kohden, ja ladata GLB-, FBX-, OBJ-, STL-, PLY- tai MetaHuman ZIP -tiedostot.
  • Tarkistaa saldosi, listata 3D-pääsi ja ladata ne uudelleen.
  • Kirjoittaa tuotantoputken skriptin idempotenssiavaimilla ja webhook-käsittelijällä tiedoston llms.txt ja skillin pohjalta.
  • Ostaa krediittejä tai kytkeä automaattista täydennystä päälle: se ohjaa sinut sen sijaan verkkosovellukseen.
  • Vahvistaa suostumusta tai hyväksyä kirjautumista puolestasi.
  • Tehdä 3D-päitä lapsista, julkisuuden henkilöistä tai internetistä löydetyistä valokuvista.

Kysymyksiä 3D-päistä tekoälyagenteilla

01Mitkä agentit toimivat?
Claude Code, Codex, Cursor, Gemini CLI ja OpenClaw sekä mikä tahansa agentti, joka osaa ajaa shell-komennon tai hakea URL-osoitteen.
02Liitänkö API-avaimen keskusteluun?
Et. Hyväksyt koodin selaimessa, ja skill säilyttää avaimen tietokoneellasi. Se ei koskaan tulosta sitä.
03Voiko agentti kuluttaa kysymättä?
Se kertoo hinnan ja saldosi ennen jokaista työtä ja pysähtyy odottamaan vahvistustasi, jos 3D-päitä on yli viisi.
04Onko MCP-palvelinta?
Ei tällä hetkellä. Skill toimii komentoriviskriptin kautta, jota agentit ajavat suoraan.

Tee MetaHuman omasta valokuvastasi.

Luo tili ilmaiseksi, lataa näytepäät ja tee 3D-päitä omista valokuvistasi, kun maksulliset paketit avautuvat.