FaceNinja

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

Votre agent IA peut faire les têtes.

Collez un prompt dans Claude Code, Codex, Cursor, Gemini CLI ou OpenClaw. Votre agent lit notre skill, l’installe, vous connecte avec un code que vous approuvez, et crée une tête MetaHuman à partir de votre photo. Aucune clé à copier. Environ 4 minutes plus tard, le GLB et le MetaHuman ZIP sont dans votre dossier.

Prompt par défaut
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.

Remplacez ./photo.jpg par le chemin de votre photo. Gardez le reste en anglais : l’agent a besoin de l’URL exactement telle qu’elle est écrite.

  • 0,01 $US le crédit, paiement à l’usage
  • 1 500 crédits par tête, tous les fichiers inclus
  • Le skill demande avant de dépenser
Trois moments d’une exécution
  1. Votre agent affiche un code comme WXYZ-2345 et le lien faceninja.net/device.

  2. Vous ouvrez /device après connexion, vérifiez le code et appuyez sur Approuver.

  3. Votre agent indique le coût et votre solde, puis enregistre le GLB et le MetaHuman ZIP.

Compte, prompt, code.

  1. Créez un compte.

    Créez un compte sur faceninja.net avec Google ou votre e-mail, et achetez les crédits correspondant aux têtes prévues. Le skill vous indique le coût avant de dépenser quoi que ce soit.

    Créer un compte

  2. Collez le prompt.

    Ouvrez votre agent dans le dossier qui contient votre photo et collez le prompt ci-dessus. L’agent récupère SKILL.md, installe le skill et lance sa CLI.

  3. Approuvez le code.

    L’agent vous montre un code court. Ouvrez faceninja.net/device après connexion, vérifiez que le code correspond, puis approuvez-le. L’agent continue tout seul.

Vous ne copiez jamais de clé. Si vous préférez en utiliser une, créez une clé API dans l’application web et définissez-la dans FACENINJA_API_KEY ; le skill l’utilise et saute le code.

Des prompts pour de vraies tâches.

Chaque prompt cite l’URL du skill : il fonctionne donc dans une session neuve, sans rien d’installé. Remplacez les chemins par les vôtres. Les prompts restent en anglais dans toutes les versions linguistiques de ce site, car l’agent doit lire exactement les URL et les noms de fichiers. Vous pourrez ensuite parler à votre agent dans votre langue.

01 · Une tête, une photo Par défaut

Votre première tête, ou un test rapide.

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

02 · Un casting depuis un dossier

Un sous-dossier par personne, de 1 à 15 photos dans chacun.

Prompt · anglais
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 casting de plus de 5 têtes s’arrête toujours pour attendre votre accord. Le skill est conçu ainsi ; le prompt ne fait que le rendre explicite. 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.

03 · FBX pour des têtes déjà créées

Retéléchargez dans un autre format. Rien de nouveau n’est créé ni facturé.

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

Les fichiers restent disponibles 30 jours après la fin d’une tête. 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.

04 · Script de pipeline webhook

Votre agent écrit l’intégration ; vous la relisez et la lancez.

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

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.

05 · Vérifier le solde

Avant un gros travail, ou quand une exécution s’est arrêtée.

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

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.

Où le coller.

Le même prompt fonctionne dans chacun. Seul l’endroit où le coller change.

Ouvrez un terminal dans le dossier de votre projet, lancez claude, puis collez le prompt.

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

Ou installez d’abord le skill pour cet agent, puis demandez :

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

S’installe dans ~/.claude/skills/faceninja (ou $CLAUDE_CONFIG_DIR/skills). Les nouvelles sessions le chargent d’elles-mêmes.

Claude Code, Codex, Cursor, Gemini CLI et OpenClaw sont des marques de leurs propriétaires. FaceNinja n’est affilié à aucun d’entre eux.

Ou installez d’abord le skill.

Demander à votre agent de lire SKILL.md est le plus rapide. Si vous préférez installer le skill vous-même, ou si votre agent ne peut pas récupérer d’URL, utilisez l’une de ces options.

macOS et Linux

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

Windows (PowerShell)

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

ZIP

Téléchargez le skill et décompressez-le là où votre agent range ses skills.

Télécharger

À lire d’abord

SKILL.md est du texte brut. Lisez-le, ou demandez à votre agent de le résumer, avant de lancer quoi que ce soit.

Voir SKILL.md

Lisez un script avant de l’envoyer dans un shell. Les deux installateurs sont courts ; ouvrez install.sh EN ou install.ps1 EN pour voir ce qu’ils font.

Ce qu’il vous faut : Python 3 pour la CLI, qui tient en un seul fichier sans dépendances, et une connexion internet. Rien d’autre n’est installé.

Pour les agents qui ne font que lire le web : https://faceninja.net/llms.txt liste la documentation, le fichier OpenAPI et le skill sous une forme que les modèles de langage lisent bien.

Ce que votre agent peut demander.

Le skill est une fine couche au-dessus de l’API FaceNinja. Votre agent peut faire ce que fait l’API, avec les vérifications ci-dessous intégrées.

Vous connecter

Avec un code que vous approuvez sur faceninja.net/device, ou avec FACENINJA_API_KEY.

Créer des têtes

De 1 à 15 photos par personne, une tête ou tout un dossier de personnes.

Les attendre

Une tête demande environ 4 minutes. Le skill attend qu’elle soit terminée ou en échec.

Télécharger tout format

GLB, FBX, OBJ, STL, PLY ou le MetaHuman ZIP, avec ou sans les 52 blendshapes ARKit.

Récupérer d’anciennes têtes

Télécharger un autre format d’une tête déjà créée, tant que ses fichiers sont conservés (30 jours).

Afficher votre solde

Les crédits restants et le nombre de têtes qu’ils couvrent.

Chaque tête créée par le skill est une tête FaceNinja complète : cartes de peau 4K, recommandations de grooms (pilosité MetaHuman), un cou ajusté et 52 blendshapes ARKit. Contenu d’une tête

Il demande avant de dépenser.

  • Le coût d’abord. Avant chaque tête, le skill vous indique ce qu’elle coûte et ce qu’il reste sur votre solde.
  • Les lots attendent un oui. Plus de 5 têtes à la fois, et le skill s’arrête et demande.
  • Les têtes en échec sont remboursées. Si une tête échoue, ses 1 500 crédits retournent d’eux-mêmes sur votre solde, et l’erreur en donne la raison.
  • Aucune clé dans votre chat. La connexion par code donne accès au skill sans qu’une clé n’apparaisse jamais dans votre prompt ni dans votre historique. Vous approuvez vous-même chaque nouvelle connexion.
  • Vous fixez le plafond. Le skill ne peut dépenser que les crédits que vous avez achetés. Il n’y a pas d’abonnement et rien à résilier.
  • Les photos sont supprimées après 30 jours. La CLI les envoie de votre disque vers FaceNinja. Que votre agent les regarde aussi dépend de l’agent et de votre prompt.
  • Seulement des visages qui ont dit oui. Utilisez des photos de vous ou d’adultes qui ont donné leur accord. Pas d’enfants, pas de photos prises sur internet. Usage acceptable EN

Questions sur les agents.

01Ai-je besoin d’une clé API ?
Non. L’agent vous montre un code, et vous l’approuvez sur faceninja.net/device. Si votre installation ne peut pas vous montrer de code, par exemple une tâche serveur, créez une clé API dans l’application web et définissez FACENINJA_API_KEY.
02Avec quels agents fonctionne-t-il ?
Claude Code, Codex, Cursor, Gemini CLI et OpenClaw, ainsi que tout agent capable d’exécuter une commande shell ou de récupérer une URL.
03Combien coûte le skill ?
Rien. Une tête coûte 1 500 crédits (15 $US), comme dans l’application web et l’API.
04Puis-je écrire le prompt dans ma langue ?
Oui, autour des URL. Gardez https://faceninja.net/skill/SKILL.md et vos chemins de fichiers exactement tels quels, et l’agent suivra le reste dans n’importe quelle langue qu’il comprend.
05Mon agent peut-il construire un pipeline entier ?
Oui. Le prompt 4 ci-dessus lui demande d’en écrire un avec des webhooks et des clés d’idempotence. La page Développeurs et la référence de l’API EN sont écrites pour qu’un agent puisse aussi les lire.
06Y a-t-il un serveur MCP ?
Pas aujourd’hui. Le skill et llms.txt couvrent les agents listés ci-dessus. Écrivez-nous si votre agent ne parle que MCP.
07L’agent voit-il mes photos ?
La CLI du skill les envoie directement depuis votre disque. Votre agent voit les noms de fichiers et les résultats. Si vous lui demandez de regarder une photo, il le fera, via son propre fournisseur.
08Où vont les fichiers ?
Là où votre prompt le dit. Le prompt par défaut utilise ./faceninja-out.

Aller plus loin.

L’API

Webhooks, clés d’idempotence et lots, pour quand le pipeline tourne sans agent.

Développeurs

La référence

Chaque endpoint, chaque champ et chaque erreur, plus un fichier OpenAPI 3.1.

Référence API EN

Une tête, sans code

Envoyez plutôt une photo depuis le navigateur.

Ouvrir l’appli web

Un prompt. Une tête terminée.

Créer un compte