FaceNinja

Agenti IA · Claude Code, Codex, Cursor, Gemini CLI, OpenClaw

Le teste può farle il tuo agente IA.

Incolla un prompt in Claude Code, Codex, Cursor, Gemini CLI o OpenClaw. Il tuo agente legge la nostra skill, la installa, ti fa accedere con un codice che approvi e crea una testa MetaHuman dalla tua foto. Nessuna chiave da copiare. Circa 4 minuti dopo, il GLB e il MetaHuman ZIP sono nella tua cartella.

Prompt predefinito
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.

Cambia ./photo.jpg con il percorso della tua foto. Lascia il resto in inglese: l'agente ha bisogno dell'URL esattamente come è scritto.

  • 0,01 USD per credito, a consumo
  • 1500 crediti a testa, ogni file incluso
  • La skill chiede prima di spendere
Tre momenti di un'esecuzione
  1. Il tuo agente stampa un codice come WXYZ-2345 e il link faceninja.net/device.

  2. Apri /device con l'accesso effettuato, controlli il codice e premi Approva.

  3. Il tuo agente indica il costo e il tuo saldo, poi salva il GLB e il MetaHuman ZIP.

Account, prompt, codice.

  1. Crea un account.

    Crea un account su faceninja.net con Google o con la tua email, e compra i crediti per le teste che prevedi. La skill ti dice il costo prima di spendere qualsiasi cosa.

    Crea un account

  2. Incolla il prompt.

    Apri il tuo agente nella cartella che contiene la tua foto e incolla il prompt qui sopra. L'agente scarica SKILL.md, installa la skill ed esegue la sua CLI.

  3. Approva il codice.

    L'agente ti mostra un codice breve. Apri faceninja.net/device con l'accesso effettuato, controlla che il codice corrisponda e approvalo. L'agente prosegue da solo.

Non copi mai una chiave. Se preferisci usarne una, crea una chiave API nell'app web e impostala come FACENINJA_API_KEY; la skill la usa e salta il codice.

Prompt per lavori veri.

Ogni prompt indica l'URL della skill, quindi funziona in una sessione nuova senza nulla di installato. Cambia i percorsi con i tuoi. I prompt restano in inglese in ogni versione linguistica di questo sito, perché l'agente deve leggere esattamente gli URL e i nomi dei file. Dopo puoi comunque parlare con il tuo agente nella tua lingua.

01 · Una testa da una foto Default

La tua prima testa, o un test veloce.

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.

02 · Un cast da una cartella

Una sottocartella per persona, da 1 a 15 foto in ciascuna.

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>.

Un cast di più di 5 teste si ferma sempre in attesa del tuo sì. La skill è fatta così; il prompt lo rende solo esplicito. Lascia questo prompt in inglese: il tuo agente ha bisogno dell'indirizzo web esattamente come è scritto. Dopo puoi parlargli nella tua lingua.

03 · FBX per teste già create

Scarica di nuovo in un altro formato. Non viene creato né addebitato nulla di nuovo.

Prompt · inglese
Use the FaceNinja skill from https://faceninja.net/skill/SKILL.md. List my finished FaceNinja heads, then download each one as FBX with the 52 ARKit blendshapes into ./faceninja-out/fbx, named after the head. Don't create any new heads.

I file restano disponibili per 30 giorni dopo il completamento di una testa. Lascia questo prompt in inglese: il tuo agente ha bisogno dell'indirizzo web esattamente come è scritto. Dopo puoi parlargli nella tua lingua.

04 · Una pipeline con webhook

Il tuo agente scrive l'integrazione; tu la rivedi e la esegui.

Prompt · inglese
Read https://faceninja.net/llms.txt and https://faceninja.net/skill/SKILL.md. Write a Python script for our pipeline: for each new folder in ./incoming, create one FaceNinja head from its photos with an Idempotency-Key derived from the folder name and a webhook_url I give you. Add a small web handler that checks the FaceNinja-Signature header, and on head.completed downloads the FBX to ./heads/<folder name>; on head.failed it logs error.code. Read the API key from FACENINJA_API_KEY. Don't run anything against my account until I say so.

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

05 · Controlla il saldo

Prima di un lavoro grosso, o quando un'esecuzione si è fermata.

Prompt · inglese
Use the FaceNinja skill from https://faceninja.net/skill/SKILL.md to show my FaceNinja balance: the credits I have and how many heads they pay for. Don't spend anything.

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

Dove incollarlo.

Lo stesso prompt funziona in ognuno di questi. Cambia solo il posto dove lo incolli.

Apri un terminale nella cartella del progetto, esegui claude e incolla il prompt.

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.

Oppure installa prima la skill per questo agente, poi chiedi:

Prompt · inglese
Install the FaceNinja skill with `curl -fsSL https://faceninja.net/skill/install.sh | sh -s -- --claude`, then read the SKILL.md it installed and follow it: sign me in (show me the code to approve) and make a MetaHuman head from ./photo.jpg. Save the GLB and the MetaHuman ZIP in ./faceninja-out.

Si installa in ~/.claude/skills/faceninja (o $CLAUDE_CONFIG_DIR/skills). Le nuove sessioni la caricano da sole.

Claude Code, Codex, Cursor, Gemini CLI e OpenClaw sono marchi dei rispettivi proprietari. FaceNinja non ha alcun rapporto di affiliazione con essi.

Oppure installa prima la skill.

Chiedere al tuo agente di leggere SKILL.md è il modo più rapido. Se preferisci installare la skill da solo, o il tuo agente non può scaricare URL, usa una di queste.

macOS e Linux

Shell
curl -fsSL https://faceninja.net/skill/install.sh | sh

Windows (PowerShell)

PowerShell
irm https://faceninja.net/skill/install.ps1 | iex

ZIP

Scarica la skill e decomprimila dove il tuo agente tiene le skill.

Scarica ZIP

Leggila prima

SKILL.md è testo semplice. Leggilo, o chiedi al tuo agente di riassumerlo, prima di eseguire qualsiasi cosa.

Apri SKILL.md

Leggi uno script prima di passarlo a una shell con una pipe. Entrambi gli installer sono brevi; apri install.sh EN o install.ps1 EN per vedere cosa fanno.

Cosa ti serve: Python 3 per la CLI, che è un solo file senza dipendenze, e una connessione a internet. Non viene installato nient'altro.

Per gli agenti che leggono solo il web: https://faceninja.net/llms.txt elenca la documentazione, il file OpenAPI e la skill in una forma che i modelli linguistici leggono bene.

Cosa può chiedere il tuo agente.

La skill è un sottile strato sopra l'API di FaceNinja. Il tuo agente può fare ciò che fa l'API, con i controlli qui sotto già inclusi.

Farti accedere

Con un codice che approvi su faceninja.net/device, oppure con FACENINJA_API_KEY.

Creare teste

Da 1 a 15 foto di una persona ciascuna: una testa o un'intera cartella di persone.

Aspettarle

Una testa richiede circa 4 minuti. La skill aspetta finché non è finita o fallita.

Scaricare qualsiasi formato

GLB, FBX, OBJ, STL, PLY o il MetaHuman ZIP, con o senza le 52 forme ARKit.

Recuperare teste precedenti

Scarica un altro formato di una testa già creata, finché i suoi file sono conservati (30 giorni).

Mostrare il saldo

I crediti rimasti e per quante teste bastano.

Ogni testa creata dalla skill è una testa FaceNinja completa: mappe pelle 4K, consigli sui groom (capelli MetaHuman), un collo adattato e 52 forme ARKit. Dentro una testa

Chiede prima di spendere.

  • Prima il costo. Prima di ogni testa, la skill ti dice quanto costa e cosa resta sul tuo saldo.
  • I batch aspettano un sì. Più di 5 teste insieme, e la skill si ferma e chiede.
  • Crediti restituiti per le teste fallite. Se una testa fallisce, i suoi 1500 crediti tornano sul tuo saldo da soli, e l'errore dice perché.
  • Nessuna chiave nella chat. L'accesso con codice dà alla skill l'accesso senza che una chiave compaia mai nel tuo prompt o nella cronologia. Approvi tu ogni nuovo accesso.
  • Il tetto lo scegli tu. La skill può spendere solo crediti che hai comprato. Nessun abbonamento e niente da disdire.
  • Le foto vengono eliminate dopo 30 giorni. La CLI le carica dal tuo disco a FaceNinja. Se anche il tuo agente le guarda dipende dall'agente e dal tuo prompt.
  • Solo volti che hanno detto sì. Usa foto di te stesso o di adulti che hanno accettato. Niente bambini, niente foto prese da internet. Uso accettabile EN

Domande sugli agenti.

01Mi serve una chiave API?
No. L'agente ti mostra un codice e lo approvi su faceninja.net/device. Se la tua configurazione non può mostrarti un codice, per esempio un job su server, crea una chiave API nell'app web e imposta FACENINJA_API_KEY.
02Con quali agenti funziona?
Claude Code, Codex, Cursor, Gemini CLI e OpenClaw, e qualsiasi agente che sappia eseguire un comando di shell o scaricare un URL.
03Quanto costa la skill?
Niente. Una testa costa 1500 crediti (15 USD), come nell'app web e nell'API.
04Posso scrivere il prompt nella mia lingua?
Sì, attorno agli URL. Lascia https://faceninja.net/skill/SKILL.md e i percorsi dei tuoi file esattamente come sono, e l'agente seguirà il resto in qualsiasi lingua capisca.
05Il mio agente può costruire un'intera pipeline?
Sì. Il prompt 4 qui sopra gli chiede di scriverne una con webhook e chiavi di idempotenza. La pagina Sviluppatori e il riferimento API EN sono scritti in modo che anche un agente possa leggerli.
06Esiste un server MCP?
Non oggi. La skill e llms.txt coprono gli agenti elencati sopra. Scrivici se il tuo agente parla solo MCP.
07L'agente vede le mie foto?
La CLI della skill le carica direttamente dal tuo disco. Il tuo agente vede i nomi dei file e i risultati. Se gli chiedi di guardare una foto, lo farà, tramite il suo provider.
08Dove vanno i file?
Dove dice il tuo prompt. Il prompt predefinito usa ./faceninja-out.

Per andare oltre.

L'API

Webhook, chiavi di idempotenza e batch, per quando la pipeline gira senza un agente.

Sviluppatori

Il riferimento

Ogni endpoint, campo ed errore, più un file OpenAPI 3.1.

Riferimento API EN

Una testa, senza codice

Carica invece una foto nel browser.

Apri l'app web

Un prompt. Una testa finita.

Crea un account