Από φωτογραφία σε MetaHuman · API και AI agents
Ένα 3D κεφάλι είναι μία κλήση API.
Στείλτε φωτογραφίες ενός ανθρώπου από τον κώδικά σας ή ζητήστε από τον AI agent σας να το κάνει. Περίπου 4 λεπτά αργότερα παίρνετε ένα έτοιμο κεφάλι MetaHuman: το δέρμα του ίδιου του ανθρώπου σε 4K, προτάσεις για groom (μαλλιά MetaHuman), λαιμό που ταιριάζει και 52 ARKit blendshapes, σε έξι μορφές. 1.500 credits το κεφάλι με 0,01 $ το credit, και ένα κεφάλι που αποτυγχάνει δεν κοστίζει τίποτα.
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.Επικολλήστε το σε Claude Code, Codex, Cursor, Gemini CLI ή OpenClaw. Εγκρίνετε έναν κωδικό· δεν χρειάζεται να αντιγράψετε κλειδί. Αφήστε αυτό το prompt στα αγγλικά: ο agent σας χρειάζεται τη διεύθυνση ακριβώς όπως είναι γραμμένη. Μετά μπορείτε να του μιλάτε στη γλώσσα σας.
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/faceninjaΕπιστρέφει αμέσως το id του κεφαλιού. Καλούμε το webhook σας όταν ολοκληρωθεί.
- 0,01 $ το credit, πληρώνετε όσο χρησιμοποιείτε
- 1.500 credits το κεφάλι, όλα τα αρχεία περιλαμβάνονται
- Χωρίς συνδρομή
- Επιστροφή credits για αποτυχημένα κεφάλια




- 1Τοπολογία MetaHumanΗ ίδια σειρά κορυφών και τα ίδια UV σε κάθε κεφάλι.
- 2Μάτια και δόντιαΣτις κόγχες τους· το χρώμα της ίριδας από τη φωτογραφία.
- 3Δέρμα σε 4KΧρώμα βάσης, normal, cavity, specular/roughness.
- 452 ARKit blendshapesΦτιαγμένα για αυτό το πρόσωπο, μαζί με το tongueOut.
- 5Λαιμός που ταιριάζειΟ λαιμός και ο τραπεζοειδής μυς ακολουθούν τον άνθρωπο.
Είσοδος: μία φωτογραφία. Έξοδος: αυτό το κεφάλι, χωρίς επεξεργασία. Συνθετικό πρόσωπο.
Σύρετε ή χρησιμοποιήστε ← →- Είσοδος
- 1 φωτογραφίαέως 15 του ίδιου ανθρώπου
- Τοπολογία
- MetaHumanκεφάλι, λαιμός, ώμοι
- Εκφράσεις
- 52 ARKitφτιαγμένα για το πρόσωπο
- Δέρμα
- 4 × 4Kχρώμα, normal, cavity, spec/rough
- Διάρκεια
- περίπου 4 λεπτάανά κεφάλι, με κάθε τρόπο
- Τιμή
- 0,01 $ανά credit · 1.500 το κεφάλι
Κάθε κλήση επιστρέφει ένα έτοιμο κεφάλι, όχι ένα φαλακρό πλέγμα.
Η αυτοματοποίηση αξίζει μόνο αν κανείς δεν χρειάζεται να τελειώσει το αποτέλεσμα με το χέρι. Αυτό περιέχει κάθε κεφάλι, από το API, από έναν agent ή από την εφαρμογή web, χωρίς επιπλέον χρέωση.
- Το πρόσωπο, σε τοπολογία MetaHuman. Κεφάλι, λαιμός και ώμοι, μάτια και δόντια. Η ίδια σειρά κορυφών και τα ίδια UV σε κάθε κεφάλι, οπότε ένα rig ταιριάζει σε όλα.
- Το δέρμα του ίδιου του ανθρώπου. Χάρτες 4K για χρώμα βάσης, normal, cavity και specular/roughness, στη διάταξη UV του MetaHuman.
- Μαλλιά, φρύδια, βλεφαρίδες και γένια, με όνομα. Προτάσεις groom MetaHuman με τιμές χρώματος, ως
groom.jsonπου διαβάζουν τα εργαλεία σας. - Λαιμός που ταιριάζει. Ο λαιμός και ο τραπεζοειδής μυς ακολουθούν τις αναλογίες του ίδιου του ανθρώπου.
- 52 ARKit blendshapes. Φτιαγμένα για αυτό το πρόσωπο, μαζί με το
tongueOut, έτοιμα για face tracking και lip sync. - Έξι μορφές. GLB, FBX, OBJ, STL, PLY και ένα MetaHuman ZIP. Ζητήστε όποια θέλετε, όσες φορές θέλετε.
Τέσσερις δύσκολες φωτογραφίες
Σκληρό φως, ρυτίδες


Η πορτοκαλί επίχρωση φεύγει από το δέρμα· οι ρυτίδες μένουν ως ανάγλυφο.
Γέλιο και γυαλιά


Το γέλιο δεν ενσωματώνεται στο σχήμα.
Γένια, στραμμένο κεφάλι


Το σαγόνι ανακτάται· τα γένια επιστρέφουν ως groom.
Μαλλιά πάνω από τα αυτιά


Το πρόσωπο είναι δικό της· το σχήμα των αυτιών δεν λαμβάνεται από τη φωτογραφία.
Κανένας από αυτούς τους ανθρώπους δεν υπάρχει. Φτιάξαμε τις φωτογραφίες ώστε να δοκιμάζουμε χωρίς το πρόσωπο κανενός. Τα κεφάλια είναι ακριβώς αυτό που προέκυψε.
Δείτε τα δείγματα.
Κάθε κεφάλι εδώ το έφτιαξε το FaceNinja από μία φωτογραφία και εμφανίζεται ακριβώς όπως προέκυψε. Έρχονται περισσότερα δείγματα, με περισσότερα είδη προσώπων, φωτισμού και μαλλιών.












Δοκιμάστε τις εκφράσεις σε ένα κεφάλι που έφτιαξε το API.
Αυτή είναι η ίδια ελαφριά προεπισκόπηση που δείχνει η εφαρμογή web για κάθε κεφάλι. Κάθε κουμπί κινεί τα ARKit blendshapes του ίδιου του κεφαλιού. Ενεργοποιήστε την προεπισκόπηση μαλλιών για να κρίνετε την ομοιότητα με τα μαλλιά.
Δείγματα κεφαλιών

Τα βέλη γυρίζουν το κεφάλι. Το συν και το πλην ζουμάρουν. Το μηδέν επαναφέρει την προβολή. Το Escape κλείνει τον viewer.
Ενδείξεις ARKit
Οι τιμές ακολουθούν την έκφραση. Σύρετε ρυθμιστικό για ένα blendshape.
Ένα κεφάλι ή πεντακόσια, η ίδια κλήση.
Ένα κεφάλι χρειάζεται περίπου 4 λεπτά, γι’ αυτό το FaceNinja είναι ασύγχρονο εξαρχής. Στέλνετε, ενημερώνεστε, παραλαμβάνετε. Όσα κάνουν ασφαλή την εκτέλεση μιας παρτίδας χωρίς επίβλεψη βρίσκονται στο API, και το skill για agents χρησιμοποιεί το ίδιο API.
Ο agent σας μπορεί να το κάνει.
- Δημιουργήστε λογαριασμό. Δημιουργήστε λογαριασμό με Google ή με το email σας και αγοράστε credits.
- Επικολλήστε ένα prompt σε Claude Code, Codex, Cursor, Gemini CLI ή OpenClaw.
- Εγκρίνετε τον κωδικό που σας δείχνει ο agent σας, στο
faceninja.net/device.
Μετά ζητήστε περισσότερα: «ένα κεφάλι για κάθε υποφάκελο του ./cast», «όλα τα κεφάλια ξανά ως FBX», «ένα webhook pipeline, γραμμένο για μένα». Το skill σάς λέει το κόστος και το υπόλοιπό σας πριν ξοδέψει, και ρωτά πριν από περισσότερα από 5 κεφάλια.
Ο κώδικάς σας μπορεί να το κάνει.
- Κλειδιά idempotency. Επαναλάβετε μια δημιουργία με το ίδιο κλειδί και παίρνετε το ίδιο κεφάλι, ποτέ δεύτερη χρέωση.
- Υπογεγραμμένα webhooks.
head.completedκαιhead.failed, υπογεγραμμένα στοFaceNinja-Signature. Ή ροή server-sent events, ή?waitγια scripts. - Χώρος για παρτίδες. 30 δημιουργίες κεφαλιών και 600 αιτήματα το λεπτό ανά λογαριασμό.
- Σφάλματα που μπορείτε να χειριστείτε με κώδικα. Σταθεροί κωδικοί όπως
no_faceκαιnot_same_person, ο καθένας με υπόδειξη. - Επιστροφές χωρίς αιτήματα υποστήριξης. Τα credits δεσμεύονται κατά τη δημιουργία και αποδεσμεύονται από μόνα τους αν ένα κεφάλι αποτύχει.
- Σύνδεσμοι, όχι συνημμένα. Κάθε αρχείο έρχεται ως υπογεγραμμένος σύνδεσμος μικρής διάρκειας. Αποθηκεύστε το id του κεφαλιού και ζητήστε το ξανά όταν το χρειαστείτε.
POST /v1/headsφωτογραφίες ενός ανθρώπου- id κεφαλιού
head.completedυπογεγραμμένο webhook όταν ολοκληρωθείPOST /v1/heads/{id}/filesμορφή- υπογεγραμμένος σύνδεσμος μικρής διάρκειας
Η αυτοματοποίηση Unreal, που προσαρμόζει το πρόσωπο, βάζει το δέρμα, τοποθετεί τα grooms και επιλέγει σώμα μέσα στο Unreal Engine, βρίσκεται σε πρώιμη πρόσβαση. Ζητήστε την Πρώιμη πρόσβαση
Τέσσερα είδη pipeline, ένα είδος κεφαλιού.
Εργαλεία και πλατφόρμες
Προσθέστε στο προϊόν σας το «φτιάξε κεφάλι από φωτογραφία». Webhooks στην είσοδο, υπογεγραμμένοι σύνδεσμοι στην έξοδο, επιστροφές χωρίς αιτήματα υποστήριξης.
DevelopersΣτούντιο παιχνιδιών
Πρόσωπα παικτών ή μια ομάδα NPC, όλα στο ίδιο πλέγμα, ώστε ένα rig και ένα υλικό να ταιριάζουν σε κάθε κεφάλι.
Κεφάλια για παιχνίδιαΌσοι δουλεύουν με agents
Αναθέστε τη δουλειά στο Claude Code, στο Codex ή στο Cursor: μια ομάδα κεφαλιών από έναν φάκελο, FBX για κάθε κεφάλι, ένα script pipeline.
Χρήση με AI agentsΤεχνικοί καλλιτέχνες
Ανοίξτε το MetaHuman Creator με το πρόσωπο ήδη προσαρμοσμένο και το δέρμα και τα grooms ήδη επιλεγμένα.
Τι έχει ένα κεφάλι0,01 $ το credit, όπως κι αν το ζητήσετε.
Το API, ο agent σας και η εφαρμογή web χρησιμοποιούν ένα κοινό υπόλοιπο, με μία τιμή. Αγοράστε credits σε πακέτο ή σε όποιο ποσό θέλετε, χωρίς συνδρομή. Ένα κεφάλι κοστίζει 1.500 credits και, αν αποτύχει, τα credits του επιστρέφουν από μόνα τους. Ο φόρος πωλήσεων ή ο ΦΠΑ προστίθεται κατά την ολοκλήρωση της αγοράς, όπου ισχύει.
Ένα κεφάλι, στον browser.
Δεν χρειάζεστε agent ή κλειδί API. Συνδεθείτε με Google, ρίξτε από μία έως 15 φωτογραφίες ενός ανθρώπου και κατεβάστε το κεφάλι περίπου 4 λεπτά αργότερα. Η εφαρμογή web δείχνει την 3D προεπισκόπηση με εκφράσεις και μαλλιά πριν το κατεβάσετε.
Πριν αυτοματοποιήσετε.
- 01Χρειάζεται να γράψω κώδικα;
- Όχι. Επικολλήστε ένα prompt σε έναν AI agent, όπως το Claude Code ή το Cursor, ή χρησιμοποιήστε την εφαρμογή web στον browser σας. Χρήση με AI agents
- 02Πόση ώρα χρειάζεται ένα κεφάλι;
- Περίπου 4 λεπτά από το ανέβασμα. Όταν περιμένουν πολλά κεφάλια, το δικό σας μπαίνει σε ουρά και το API αναφέρει τη θέση του στη σειρά.
- 03Πόσες φωτογραφίες χρειάζομαι;
- Αρκεί μία καθαρή φωτογραφία. Έως 15 φωτογραφίες του ίδιου ανθρώπου βοηθούν, ιδίως μία από το προφίλ και μία από τα τρία τέταρτα. Συμβουλές φωτογραφίας
- 04Τι γίνεται αν ένα κεφάλι αποτύχει;
- Τα 1.500 credits του επιστρέφουν στο υπόλοιπό σας από μόνα τους και το
error.codeλέει γιατί, για παράδειγμαno_face. - 05Είναι τα μαλλιά μέρος του κεφαλιού;
- Όχι. Στο MetaHuman, τα μαλλιά, τα φρύδια και τα γένια είναι grooms. Προτείνουμε τα σωστά, με τα χρώματά τους, ως δεδομένα που διαβάζουν τα εργαλεία σας.
- 06Ποιανού φωτογραφίες μπορώ να χρησιμοποιήσω;
- Τις δικές σας ή φωτογραφίες ενήλικα που συμφώνησε να φτιαχτεί ένα 3D κεφάλι του. Δεν φτιάχνουμε κεφάλια παιδιών ούτε από φωτογραφίες που βρέθηκαν στο διαδίκτυο. Αποδεκτή χρήση EN
- 07Τι γίνεται με τις φωτογραφίες μου;
- Διαγράφονται μετά από 30 ημέρες και μπορείτε να διαγράψετε νωρίτερα ένα κεφάλι και τις φωτογραφίες του. Πολιτική απορρήτου EN
Το πρώτο σας κεφάλι απέχει ένα prompt.
Δημιουργήστε λογαριασμό, αγοράστε credits, επικολλήστε το prompt και εγκρίνετε τον κωδικό.