Da foto a MetaHuman · API e agenti IA
Una testa è una chiamata API.
Invia le foto di una persona dal tuo codice, o chiedilo al tuo agente IA. Circa 4 minuti dopo ricevi una testa MetaHuman finita: la pelle della persona in 4K, consigli sui groom (capelli MetaHuman), un collo adattato e 52 forme ARKit, in sei formati. 1500 crediti a testa a 0,01 USD per credito, e i crediti di una testa fallita tornano da soli.
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.Incolla in Claude Code, Codex, Cursor, Gemini CLI o OpenClaw. Approvi un codice; nessuna chiave da copiare. Lascia questo prompt in inglese: il tuo agente ha bisogno dell'indirizzo web esattamente come è scritto. Dopo puoi parlargli nella tua lingua.
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/faceninjaRestituisce subito l'id della testa. Chiamiamo il tuo webhook quando è pronta.
- 0,01 USD per credito, a consumo
- 1500 crediti a testa, ogni file incluso
- Nessun abbonamento
- Teste fallite: crediti restituiti
- 1Topologia MetaHumanStesso ordine dei vertici e stesse UV su ogni testa.
- 2Occhi e dentiNelle loro orbite; colore dell'iride dalla foto.
- 3Pelle in 4KColore base, normal, cavity, specular/roughness.
- 452 forme ARKitFatte per questo volto, tongueOut incluso.
- 5Un collo che si adattaCollo e trapezio seguono la persona.
In ingresso: una foto. In uscita: questa testa, senza ritocchi. Una persona sintetica.
Trascina o usa ← →- Input
- 1 fotofino a 15 della stessa persona
- Topologia
- MetaHumantesta, collo, spalle
- Espressioni
- 52 ARKitfatte per il volto
- Mappe pelle
- 4 × 4Kcolore, normal, cavity, spec/rough
- Durata
- circa 4 minper testa, da qualsiasi canale
- Tariffa
- 0,01 USDper credito · 1500 a testa
Ogni chiamata restituisce una testa finita, non una mesh calva.
L'automazione vale la pena solo se nessuno deve rifinire il risultato a mano. Ecco cosa contiene ogni testa, da API, agente o app web, senza costi aggiuntivi.
- Il volto, in topologia MetaHuman. Testa, collo e spalle, occhi e denti. Stesso ordine dei vertici e stesse UV su ogni testa, così un solo rig va bene per tutte.
- La pelle della persona stessa. Mappe 4K di colore base, normal, cavity e specular/roughness, nel layout UV di MetaHuman.
- Capelli, sopracciglia, ciglia e barba, indicati per nome. Consigli sui groom MetaHuman con i valori di colore, come
groom.jsonche i tuoi strumenti possono leggere. - Un collo che si adatta. Collo e trapezio seguono le proporzioni della persona.
- 52 forme ARKit. Fatte per questo volto,
tongueOutincluso, pronte per face tracking e lip sync. - Sei formati. GLB, FBX, OBJ, STL, PLY e un MetaHuman ZIP. Chiedili tutti, quante volte vuoi.
Quattro foto difficili
Luce dura, rughe marcate
La dominante arancione è sparita dalla pelle; le rughe restano come rilievo.
Una risata e occhiali
La risata non finisce nella forma.
Barba folta, viso girato
La mascella viene recuperata; la barba torna come groom.
Capelli sulle orecchie
Il volto è il suo; la forma delle orecchie non viene presa dalla foto.
Nessuna di queste persone esiste. Abbiamo generato noi le foto per poter testare senza il volto di nessuno. Le teste sono esattamente ciò che è uscito.
Guarda gli esempi.
Ogni testa qui è stata creata da FaceNinja da una sola foto ed è mostrata esattamente com'è uscita. Altri esempi in arrivo, con più tipi di volti, luci e capelli.
Prova le espressioni su una testa creata dall'API.
È la stessa anteprima leggera che l'app web mostra per ogni testa. Ogni pulsante muove le forme ARKit della testa stessa. Attiva l'anteprima dei capelli per giudicare la somiglianza con i capelli.
Teste di esempio
Le frecce ruotano la testa. Più e meno zoomano. Zero reimposta la vista. Esc esce dal viewer.
Valori ARKit
I valori seguono l'espressione. Trascina un cursore per fissarne uno.
Una testa o cinquecento, la stessa chiamata.
Una testa richiede circa 4 minuti, quindi FaceNinja è asincrono fin dall'inizio. Invii, ricevi risposta, scarichi. Tutto ciò che rende sicuro eseguire un batch senza supervisione è nell'API, e la skill per agenti usa la stessa API.
Può farlo il tuo agente.
- Crea un account. Crea un account con Google o con la tua email e compra crediti.
- Incolla un prompt in Claude Code, Codex, Cursor, Gemini CLI o OpenClaw.
- Approva il codice che il tuo agente ti mostra su
faceninja.net/device.
Poi chiedi altro: “una testa per ogni sottocartella di ./cast”, “ogni testa di nuovo in FBX”, “scrivimi una pipeline con i webhook”. La skill ti dice il costo e il tuo saldo prima di spendere, e chiede conferma per più di 5 teste.
Può farlo il tuo codice.
- Chiavi di idempotenza. Ripeti una creazione con la stessa chiave e ottieni la stessa testa, mai un secondo addebito.
- Webhook firmati.
head.completedehead.failed, firmati inFaceNinja-Signature. Oppure un flusso di server-sent event, o?waitper gli script. - Spazio per i batch. 30 creazioni di teste e 600 richieste al minuto per account.
- Errori che il codice sa distinguere. Codici stabili come
no_faceenot_same_person, ciascuno con un suggerimento. - Rimborsi senza ticket. I crediti vengono trattenuti alla creazione e rilasciati da soli se una testa fallisce.
- Link, non allegati. Ogni file arriva come link firmato di breve durata. Salva l'id della testa e richiedilo quando ti serve.
POST /v1/headsfoto di una persona- id della testa
head.completedwebhook firmato al terminePOST /v1/heads/{id}/filesformato- link firmato di breve durata
L'automazione per Unreal, che adatta il volto, imposta la pelle, applica i groom e sceglie un corpo dentro Unreal Engine, è in accesso anticipato. Richiedila Accesso anticipato
Quattro tipi di pipeline, un solo tipo di testa.
Strumenti e piattaforme
Aggiungi “crea una testa da una foto” al tuo prodotto. Webhook in ingresso, link firmati in uscita, rimborsi senza ticket di assistenza.
Sviluppatori
Studi di videogiochi
Volti dei giocatori o un cast di NPC, tutti sulla stessa mesh, così un solo rig e un solo materiale vanno bene per ogni testa.
Teste per un videogioco
Chi lavora con gli agenti
Affida il lavoro a Claude Code, Codex o Cursor: un cast da una cartella, FBX per ogni testa, uno script di pipeline.
Usa con agenti IA
Technical artist
Apri MetaHuman Creator con l'adattamento del volto, la pelle e i groom già decisi.
Dentro una testa0,01 USD per credito, da qualunque canale tu parta.
L'API, il tuo agente e l'app web attingono a un unico saldo, allo stesso prezzo. Compra crediti in un pacchetto o per qualsiasi importo, senza abbonamento. Una testa costa 1500 crediti e, se fallisce, i suoi crediti tornano da soli. L'IVA o l'imposta sulle vendite viene aggiunta al checkout dove si applica.
Una testa, nel browser.
Non ti serve un agente né una chiave API. Accedi con Google, carica da una a 15 foto della stessa persona e scarica la testa in circa 4 minuti. L'app web mostra l'anteprima 3D con espressioni e capelli prima del download.
Prima di automatizzare.
- 01Devo scrivere codice?
- No. Incolla un prompt in un agente IA come Claude Code o Cursor, oppure usa l'app web nel browser. Usa con agenti IA
- 02Quanto ci mette una testa?
- Circa 4 minuti dal caricamento. Quando molte teste sono in attesa, la tua va in coda e l'API indica la sua posizione.
- 03Quante foto mi servono?
- Basta una foto nitida. Fino a 15 foto della stessa persona aiutano, soprattutto un profilo e una vista di tre quarti. Consigli foto
- 04Cosa succede se una testa fallisce?
- I suoi 1500 crediti tornano sul tuo saldo da soli, e
error.codedice perché, per esempiono_face. - 05I capelli fanno parte della testa?
- No. In MetaHuman capelli, sopracciglia e barba sono groom. Consigliamo quelli giusti con i loro colori, come dati che i tuoi strumenti possono leggere.
- 06Quali foto posso usare?
- Le tue, o foto di un adulto che ha accettato che ne venga creata una testa 3D. Non creiamo teste di bambini né da foto trovate online. Uso accettabile EN
- 07Che fine fanno le mie foto?
- Vengono eliminate dopo 30 giorni, e puoi eliminare una testa e le sue foto prima. Informativa sulla privacy EN
La tua prima testa è a un prompt di distanza.
Crea un account, compra crediti, incolla il prompt e approva il codice.