Créer des têtes 3D depuis Claude Code, Codex ou Cursor.

La première exécution, pas à pas

1. Collez un prompt

   Ouvrez votre agent dans le dossier qui contient votre photo et collez ceci. Cela fonctionne avec tout agent capable de lancer une commande shell ou de récupérer une URL ; la page des agents en propose une version pour chacun.

   Prompt · anglaisCopier prompt

   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.

   Gardez ce prompt en anglais : votre agent a besoin de l’adresse web exactement telle qu’elle est écrite. Vous pourrez ensuite lui parler dans votre langue.

2. Approuvez le code de connexion

   L’agent vous montre un code court et ouvre faceninja.net/device. Vous vous y connectez et approuvez le code. Aucune clé API n’est collée dans le chat ; la skill garde sa clé sur votre ordinateur et ne l’affiche jamais.

3. Confirmez votre droit d’utiliser les photos

   Avant la première tête, l’agent vous montre une déclaration à confirmer avec vos propres mots : vous avez le droit d’utiliser les photos et le consentement de chaque personne, ce sont des adultes, et vous respectez la Politique de contenu et de droit à l’image EN. L’agent ne la confirme jamais à votre place.

4. L’agent annonce d’abord le coût

   Il consulte votre solde et vous dit ce que coûte une tête et ce qui restera, avant de dépenser quoi que ce soit. Au-delà de cinq têtes, il s’arrête et vous demande de confirmer le total.

5. Essayez les exemples gratuits

   Même sans aucun crédit, l’agent peut télécharger les 20 têtes d’exemple : vous pouvez donc tester d’abord le reste de votre pipeline.

6. Une tête, puis un dossier

   Pour un casting, placez les photos de chaque personne dans son propre sous-dossier et collez le prompt de casting. L’agent compte les têtes, annonce le total et attend votre accord.

   Prompt · anglaisCopier prompt

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

   Gardez ce prompt en anglais : votre agent a besoin de l’adresse web exactement telle qu’elle est écrite. Vous pourrez ensuite lui parler dans votre langue.

Ce que la skill exécute

La skill est un seul fichier Python, sans package à installer (Python 3.9 ou plus récent). Votre agent l’exécute ; vous pouvez aussi le faire. Voici son aide, telle quelle :

$ 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 que l’agent peut et ne peut pas faire

• Créer des têtes à partir de 1 à 15 photos d’une personne, une tête par sous-dossier, et télécharger GLB, FBX, OBJ, STL, PLY ou le MetaHuman ZIP.
• Consulter votre solde, lister vos têtes et les retélécharger.
• Écrire un script de pipeline avec clés d’idempotence et gestionnaire de webhook, à partir de llms.txt et de la skill.

• Acheter des crédits ou activer les recharges automatiques : il vous renvoie vers l’application web.
• Confirmer le consentement ou approuver une connexion à votre place.
• Créer des têtes d’enfants, de personnalités publiques ou à partir de photos trouvées en ligne.

Questions sur les têtes créées par des agents IA

01Quels agents fonctionnent ?

Claude Code, Codex, Cursor, Gemini CLI et OpenClaw, et tout agent capable de lancer une commande shell ou de récupérer une URL.

02Dois-je coller une clé API dans le chat ?

Non. Vous approuvez un code dans votre navigateur, et la skill garde la clé sur votre ordinateur. Elle ne l’affiche jamais.

03L’agent peut-il dépenser sans demander ?

Il vous indique le coût et votre solde avant chaque tâche, et s’arrête pour confirmation au-delà de cinq têtes.

04Existe-t-il un serveur MCP ?

Pas aujourd’hui. La skill fonctionne via un script en ligne de commande que les agents exécutent directement.