FaceNinja
Italiano
Crea un account

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

Crea teste 3D da Claude Code, Codex o Cursor.

Il tuo agente IA di coding può creare teste MetaHuman per te: una testa da una foto, un cast da una cartella, file FBX per tutte le tue teste o uno script per la tua pipeline. Questa guida segue la prima esecuzione, cosa ti chiede l'agente e cosa può e non può fare.

Pubblicato

La prima esecuzione, passo dopo passo

  1. Incolla un prompt

    Apri il tuo agente nella cartella con la tua foto e incolla questo. Funziona con qualsiasi agente che possa eseguire un comando di shell o scaricare un URL; la pagina degli agenti ha una versione per ciascuno.

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

    Lascia questo prompt in inglese: il tuo agente ha bisogno dell'indirizzo web esattamente come è scritto. Dopo puoi parlargli nella tua lingua.

  2. Approva il codice di accesso

    L'agente ti mostra un codice breve e apre faceninja.net/device. Lì accedi e approvi il codice. Nessuna chiave API viene incollata nella chat; la skill tiene la sua chiave sul tuo computer e non la mostra mai.

  3. Conferma che puoi usare le foto

    Prima della prima testa, l'agente ti mostra una dichiarazione da confermare con parole tue: hai il diritto di usare le foto e il consenso di ogni persona, sono adulti e rispetti la Politica su contenuti e diritto all'immagine EN. L'agente non la conferma mai al posto tuo.

  4. L'agente indica prima il costo

    Controlla il tuo saldo e ti dice quanto costa una testa e quanto resta, prima di spendere qualsiasi cosa. Per più di cinque teste si ferma e ti chiede di confermare il totale.

  5. Prova gli esempi gratuiti

    Anche senza crediti, l'agente può scaricare le 20 teste di esempio, così puoi provare prima il resto della tua pipeline.

  6. Una testa, poi una cartella

    Per un cast, metti le foto di ogni persona in una sua sottocartella e incolla il prompt per il cast. L'agente conta le teste, indica il totale e aspetta il tuo sì.

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

    Lascia questo prompt in inglese: il tuo agente ha bisogno dell'indirizzo web esattamente come è scritto. Dopo puoi parlargli nella tua lingua.

Cosa esegue la skill

La skill è un unico file Python senza pacchetti da installare (Python 3.9 o successivo). La esegue il tuo agente; puoi farlo anche tu. Questo è il suo help, senza modifiche:

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

Cosa l'agente può e non può fare

  • Creare teste da 1–15 foto di una persona, una testa per sottocartella, e scaricare GLB, FBX, OBJ, STL, PLY o il MetaHuman ZIP.
  • Controllare il tuo saldo, elencare le tue teste e scaricarle di nuovo.
  • Scrivere uno script di pipeline con chiavi di idempotenza e un handler di webhook, partendo da llms.txt e dalla skill.
  • Comprare crediti o attivare le ricariche automatiche: ti manda invece all'app web.
  • Confermare il consenso o approvare un accesso al posto tuo.
  • Creare teste di bambini, di personaggi pubblici o da foto trovate online.

Domande sulle teste create da agenti IA

01Quali agenti funzionano?
Claude Code, Codex, Cursor, Gemini CLI e OpenClaw, e qualsiasi agente che possa eseguire un comando di shell o scaricare un URL.
02Devo incollare una chiave API nella chat?
No. Approvi un codice nel browser e la skill tiene la chiave sul tuo computer. Non la mostra mai.
03L'agente può spendere senza chiedere?
Ti indica il costo e il tuo saldo prima di ogni lavoro, e oltre le cinque teste si ferma per chiederti conferma.
04C'è un server MCP?
Oggi no. La skill funziona tramite uno script a riga di comando che gli agenti eseguono direttamente.

Crea un MetaHuman dalla tua foto.

Registrati gratis, scarica le teste di esempio e crea teste dalle tue foto quando apriranno i piani a pagamento.

Crea un accountUsalo con agenti IA