De la photo au MetaHuman · API et agents IA
Une tête, c’est un appel d’API.
Envoyez des photos d’une personne depuis votre code, ou demandez-le à votre agent IA. Environ 4 minutes plus tard, vous obtenez une tête MetaHuman terminée : la peau de la personne en 4K, des recommandations de groom (pilosité MetaHuman), un cou ajusté et 52 blendshapes ARKit, en six formats. 1 500 crédits la tête à 0,01 $US le crédit, et une tête en échec ne coûte rien.
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.À coller dans Claude Code, Codex, Cursor, Gemini CLI ou OpenClaw. Vous approuvez un code ; aucune clé à copier. 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.
curl https://api.faceninja.net/v1/heads \
-H "Authorization: Bearer $FACENINJA_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-F photos=@photo.jpg -F webhook_url=https://you.example/hooks/faceninjaRenvoie tout de suite l’identifiant de la tête. Nous appelons votre webhook quand elle est prête.
- 0,01 $US le crédit, paiement à l’usage
- 1 500 crédits par tête, tous les fichiers inclus
- Sans abonnement
- Têtes en échec remboursées
- 1Topologie MetaHumanLe même ordre de sommets et les mêmes UV sur chaque tête.
- 2Yeux et dentsDans leurs orbites ; couleur de l’iris tirée de la photo.
- 3Peau en 4KCouleur de base, normales, cavité, spéculaire/rugosité.
- 452 blendshapes ARKitFaits pour ce visage, tongueOut compris.
- 5Un cou ajustéLe cou et les trapèzes suivent la personne.
Entrée : une photo. Sortie : cette tête, sans retouche. Personne synthétique.
Glissez, ou ← → au clavier- Entrée
- 1 photojusqu’à 15 d’une même personne
- Topologie
- MetaHumantête, cou, épaules
- Expressions
- 52 ARKitfaits pour le visage
- Cartes peau
- 4 × 4Kcouleur, normales, cavité, spéculaire/rugosité
- Durée
- environ 4 minpar tête, quel que soit l’accès
- Tarif
- 0,01 $USpar crédit · 1 500 par tête
Chaque appel renvoie une tête terminée, pas un maillage chauve.
L’automatisation n’a d’intérêt que si personne n’a à terminer le résultat à la main. Voici ce que contient chaque tête, depuis l’API, un agent ou l’application web, sans supplément.
- Le visage, en topologie MetaHuman. Tête, cou et épaules, yeux et dents. Le même ordre de sommets et les mêmes UV sur chaque tête : un seul rig convient à toutes.
- La peau de la personne elle-même. Cartes 4K de couleur de base, de normales, de cavité et de spéculaire/rugosité, dans la disposition UV de MetaHuman.
- Cheveux, sourcils, cils et barbe, nommés. Recommandations de grooms MetaHuman avec leurs valeurs de couleur, dans un
groom.jsonque vos outils savent lire. - Un cou ajusté. Le cou et les trapèzes suivent les proportions de la personne.
- 52 blendshapes ARKit. Faits pour ce visage,
tongueOutcompris, prêts pour le suivi facial et la synchro labiale. - Six formats. GLB, FBX, OBJ, STL, PLY et un MetaHuman ZIP. Demandez n’importe lequel, aussi souvent que vous voulez.
Quatre photos difficiles
Lumière dure, rides
La dominante orange a disparu de la peau ; les rides restent en relief.
Un rire et des lunettes
Le rire n’est pas figé dans la forme.
Barbe fournie, de côté
La mâchoire est retrouvée ; la barbe revient sous forme de groom.
Cheveux sur les oreilles
Le visage est le sien ; la forme des oreilles n’est pas tirée de la photo.
Aucune de ces personnes n’existe. Nous avons généré les photos pour tester sans le visage de quiconque. Les têtes sont exactement le résultat obtenu.
Voir les exemples.
Chaque tête ici a été faite par FaceNinja à partir d’une seule photo et s’affiche exactement telle qu’elle est sortie. D’autres exemples arrivent, avec plus de types de visages, de lumières et de cheveux.
Essayez les expressions sur une tête créée par l’API.
C’est le même aperçu léger que l’application web affiche pour chaque tête. Chaque bouton pilote les blendshapes ARKit de la tête elle-même. Activez l’aperçu des cheveux pour juger la ressemblance avec les cheveux.
Têtes d’exemple
Les flèches font tourner la tête. Plus et moins zooment. Zéro réinitialise la vue. Échap quitte la visionneuse.
Valeurs ARKit
Les valeurs suivent l’expression. Un curseur règle un blendshape.
Une tête ou cinq cents, le même appel.
Une tête demande environ 4 minutes : FaceNinja est donc asynchrone dès le départ. Vous envoyez, on vous répond, vous récupérez. Tout ce qui permet de lancer un lot sans surveillance, en toute sécurité, est dans l’API, et le skill d’agent utilise cette même API.
Votre agent peut le faire.
- Créez un compte. Créez un compte avec Google ou votre e-mail, puis achetez des crédits.
- Collez un prompt dans Claude Code, Codex, Cursor, Gemini CLI ou OpenClaw.
- Approuvez le code que votre agent vous montre sur
faceninja.net/device.
Demandez ensuite davantage : « une tête par sous-dossier de ./cast », « toutes les têtes à nouveau en FBX », « écrivez-moi un pipeline de webhooks ». Le skill vous indique le coût et votre solde avant de dépenser, et vous demande avant d’en faire plus de 5.
Votre code peut le faire.
- Clés d’idempotence. Relancez une création avec la même clé : vous obtenez la même tête, jamais un second débit.
- Webhooks signés.
head.completedethead.failed, signés dansFaceNinja-Signature. Ou un canal d’événements envoyés par le serveur, ou?waitpour les scripts. - De la place pour les lots. 30 créations de tête et 600 requêtes par minute et par compte.
- Des erreurs que votre code sait traiter. Des codes stables comme
no_faceetnot_same_person, chacun avec une indication. - Remboursements sans ticket. Les crédits sont réservés à la création et se libèrent d’eux-mêmes si une tête échoue.
- Des liens, pas des pièces jointes. Chaque fichier arrive sous forme de lien signé à courte durée de vie. Conservez l’identifiant de la tête, redemandez-le quand vous en avez besoin.
POST /v1/headsphotos d’une personne- id de la tête
head.completedwebhook signé une fois terminéePOST /v1/heads/{id}/filesformat- lien signé à durée limitée
L’automatisation Unreal, qui conforme le visage, applique la peau, pose les grooms et choisit un corps dans Unreal Engine, est en accès anticipé. Demandez-la Accès anticipé
Quatre types de pipeline, un seul type de tête.
Outils et plateformes
Ajoutez « créer une tête à partir d’une photo » à votre produit. Webhooks en entrée, liens signés en sortie, remboursements sans ticket au support.
Développeurs
Studios de jeu
Des visages de joueurs ou un casting de PNJ, tout sur un même maillage : un seul rig et un seul matériau conviennent à chaque tête.
Des têtes pour un jeu
Utilisateurs d’agents
Confiez le travail à Claude Code, Codex ou Cursor : un casting à partir d’un dossier, du FBX pour chaque tête, un script de pipeline.
Utiliser avec des agents IA
Artistes techniques
Ouvrez MetaHuman Creator avec l’ajustement du visage, la peau et les grooms déjà décidés.
Contenu d’une tête0,01 $US le crédit, quelle que soit la façon de demander.
L’API, votre agent et l’application web puisent dans un même solde, au même prix. Achetez des crédits en pack ou pour le montant de votre choix, sans abonnement. Une tête coûte 1 500 crédits, et si elle échoue, ses crédits reviennent d’eux-mêmes. La taxe de vente ou la TVA est ajoutée au paiement là où elle s’applique.
Une tête, dans le navigateur.
Pas besoin d’agent ni de clé API. Connectez-vous avec Google, déposez de 1 à 15 photos d’une même personne, et téléchargez la tête en environ 4 minutes. L’application web affiche l’aperçu 3D avec les expressions et les cheveux avant le téléchargement.
Avant d’automatiser.
- 01Dois-je écrire du code ?
- Non. Collez un prompt dans un agent IA comme Claude Code ou Cursor, ou utilisez l’application web dans votre navigateur. Utiliser avec des agents IA
- 02Combien de temps prend une tête ?
- Environ 4 minutes à partir de l’envoi des photos. Quand beaucoup de têtes attendent, la vôtre fait la queue, et l’API indique sa place dans la file.
- 03Combien de photos me faut-il ?
- Une photo nette suffit. Jusqu’à 15 photos de la même personne aident, surtout un profil et une vue de trois quarts. Conseils photo
- 04Que se passe-t-il si une tête échoue ?
- Ses 1 500 crédits retournent d’eux-mêmes sur votre solde, et
error.codeen donne la raison, par exempleno_face. - 05Les cheveux font-ils partie de la tête ?
- Non. Dans MetaHuman, les cheveux, les sourcils et les barbes sont des grooms. Nous recommandons les bons, avec leurs couleurs, sous forme de données que vos outils savent lire.
- 06De qui puis-je utiliser les photos ?
- Les vôtres, ou celles d’un adulte qui a accepté qu’on fasse une tête 3D de lui. Nous ne faisons pas de têtes d’enfants ni à partir de photos trouvées en ligne. Usage acceptable EN
- 07Que deviennent mes photos ?
- Elles sont supprimées après 30 jours, et vous pouvez supprimer plus tôt une tête et ses photos. Politique de confidentialité EN
Votre première tête est à un prompt d’ici.
Créez un compte, achetez des crédits, collez le prompt et approuvez le code.