Foto zu MetaHuman · API und KI-Agenten
Ein Kopf ist ein API-Aufruf.
Senden Sie Fotos einer Person aus Ihrem Code, oder bitten Sie Ihren KI-Agenten darum. Etwa 4 Minuten später haben Sie einen fertigen MetaHuman-Kopf: die eigene Haut der Person in 4K, Groom-Empfehlungen (MetaHuman-Haar), einen passenden Hals und 52 ARKit-Blendshapes, in sechs Formaten. 1.500 Credits pro Kopf bei 0,01 $ pro Credit, und ein fehlgeschlagener Kopf kostet nichts.
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.In Claude Code, Codex, Cursor, Gemini CLI oder OpenClaw einfügen. Sie geben einen Code frei; kein Schlüssel zum Kopieren. Lassen Sie diesen Prompt auf Englisch: Ihr Agent braucht die Webadresse genau so, wie sie dasteht. Danach können Sie in Ihrer Sprache mit ihm sprechen.
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/faceninjaGibt sofort die ID des Kopfs zurück. Wir rufen Ihren Webhook auf, wenn er fertig ist.
- 0,01 $ pro Credit, nach Bedarf bezahlen
- 1.500 Credits pro Kopf, alle Dateien inklusive
- Kein Abo
- Fehlgeschlagene Köpfe werden erstattet
- 1MetaHuman-TopologieBei jedem Kopf dieselbe Vertex-Reihenfolge und dieselben UVs.
- 2Augen und ZähneIn ihren Augenhöhlen; Irisfarbe aus dem Foto.
- 3Haut in 4KBase Color, Normal, Cavity, Specular/Roughness.
- 452 ARKit-BlendshapesFür dieses Gesicht gebaut, tongueOut eingeschlossen.
- 5Ein Hals, der passtHals und Trapezmuskel folgen der Person.
Eingabe: ein Foto. Ausgabe: dieser Kopf, unbearbeitet. Eine synthetische Person.
Ziehen oder mit ← → bewegen- Eingabe
- 1 Fotobis zu 15 von einer Person
- Topologie
- MetaHumanKopf, Hals, Schultern
- Mimik
- 52 ARKitfür das Gesicht gebaut
- Hautmaps
- 4 × 4KColor, Normal, Cavity, Spec/Rough
- Laufzeit
- etwa 4 minpro Kopf, jeder Weg
- Preis
- 0,01 $pro Credit · 1.500 pro Kopf
Jeder Aufruf liefert einen fertigen Kopf, kein kahles Mesh.
Automatisierung lohnt sich nur, wenn niemand das Ergebnis von Hand nacharbeiten muss. Das steckt in jedem Kopf, ob aus der API, von einem Agenten oder aus der Web-App, ohne Aufpreis.
- Das Gesicht, in MetaHuman-Topologie. Kopf, Hals und Schultern, Augen und Zähne. Bei jedem Kopf dieselbe Vertex-Reihenfolge und dieselben UVs, sodass ein Rig auf alle passt.
- Die eigene Haut der Person. 4K-Maps für Base Color, Normal, Cavity und Specular/Roughness, im UV-Layout von MetaHuman.
- Haare, Brauen, Wimpern und Bart, benannt. Empfehlungen für MetaHuman-Grooms mit Farbwerten, als
groom.json, das Ihre Tools lesen können. - Ein Hals, der passt. Hals und Trapezmuskel folgen den Proportionen der Person.
- 52 ARKit-Blendshapes. Für dieses Gesicht gebaut,
tongueOuteingeschlossen, bereit für Face-Tracking und Lippensynchronisation. - Sechs Formate. GLB, FBX, OBJ, STL, PLY und ein MetaHuman ZIP. Fordern Sie jedes davon an, so oft Sie möchten.
Vier schwierige Fotos
Hartlicht, tiefe Falten
Der Orangestich ist aus der Haut verschwunden; die Falten bleiben als Relief.
Lachen und Brille
Das Lachen ist nicht in die Form eingebacken.
Vollbart, Kopf gedreht
Der Kiefer ist rekonstruiert; der Bart kommt als Groom zurück.
Haare über den Ohren
Das Gesicht ist ihres; die Ohrform wird nicht aus dem Foto übernommen.
Keine dieser Personen existiert. Wir haben die Fotos erzeugt, um ohne das Gesicht irgendeines Menschen testen zu können. Die Köpfe sind genau das, was herauskam.
Sehen Sie sich die Beispiele an.
Jeder Kopf hier wurde von FaceNinja aus einem Foto erstellt und wird genau so gezeigt, wie er herauskam. Weitere Beispiele folgen, mit mehr Arten von Gesichtern, Licht und Haaren.
Probieren Sie die Mimik an einem Kopf aus, den die API erstellt hat.
Das ist dieselbe leichte Vorschau, die die Web-App für jeden Kopf zeigt. Jede Schaltfläche steuert die eigenen ARKit-Blendshapes des Kopfs. Schalten Sie die Haarvorschau ein, um die Ähnlichkeit mit Haaren zu beurteilen.
Beispielköpfe
Pfeiltasten drehen den Kopf. Plus und Minus zoomen. Null setzt die Ansicht zurück. Escape verlässt den Viewer.
ARKit-Werte
Die Werte folgen der Mimik. Ein Regler setzt eine Blendshape.
Ein Kopf oder fünfhundert, derselbe Aufruf.
Ein Kopf braucht etwa 4 Minuten, deshalb ist FaceNinja von Anfang an asynchron. Sie senden, bekommen Rückmeldung und rufen ab. Alles, was einen Batch sicher unbeaufsichtigt laufen lässt, steckt in der API, und der Skill für KI-Agenten nutzt dieselbe API.
Das kann Ihr Agent.
- Konto erstellen. Legen Sie ein Konto mit Google oder Ihrer E-Mail-Adresse an und kaufen Sie Credits.
- Einen Prompt einfügen in Claude Code, Codex, Cursor, Gemini CLI oder OpenClaw.
- Den Code freigeben auf
faceninja.net/device. Ihr Agent zeigt ihn Ihnen an.
Bitten Sie danach um mehr: „einen Kopf pro Unterordner von ./cast“, „jeden Kopf noch einmal als FBX“, „eine Webhook-Pipeline“. Der Skill nennt Ihnen die Kosten und Ihr Guthaben, bevor er Credits ausgibt, und fragt nach, bevor es um mehr als 5 Köpfe geht.
Das kann Ihr Code.
- Idempotenzschlüssel. Wiederholen Sie das Erstellen mit demselben Schlüssel, bekommen Sie denselben Kopf, nie eine zweite Abbuchung.
- Signierte Webhooks.
head.completedundhead.failed, signiert inFaceNinja-Signature. Oder ein Server-Sent-Events-Stream, oder?waitfür Skripte. - Platz für Batches. 30 Kopf-Erstellungen und 600 Anfragen pro Minute und Konto.
- Fehler, auf die Sie verzweigen können. Stabile Codes wie
no_faceundnot_same_person, jeweils mit einem Hinweis. - Erstattungen ohne Tickets. Credits werden beim Erstellen reserviert und von selbst wieder freigegeben, wenn ein Kopf fehlschlägt.
- Links statt Anhänge. Jede Datei kommt als kurzlebiger, signierter Link. Speichern Sie die Kopf-ID und fragen Sie erneut an, wenn Sie sie brauchen.
POST /v1/headsFotos einer Person- Kopf-ID
head.completedsignierter Webhook, wenn der Kopf fertig istPOST /v1/heads/{id}/filesFormat- kurzlebiger, signierter Link
Die Unreal-Automatisierung gleicht in Unreal Engine das Gesicht an, setzt die Haut, bringt die Grooms an und wählt einen Körper. Sie ist im Early Access. Zugang anfragen Early Access
Vier Arten von Pipeline, eine Art Kopf.
Tools und Plattformen
Bauen Sie „Kopf aus einem Foto erstellen“ in Ihr Produkt ein. Webhooks rein, signierte Links raus, Erstattungen ohne Support-Tickets.
Entwickler
Spielestudios
Spielergesichter oder ein NPC-Cast, alles auf einem Mesh, sodass ein Rig und ein Material zu jedem Kopf passen.
Köpfe für ein Spiel
Wer mit KI-Agenten arbeitet
Geben Sie den Job an Claude Code, Codex oder Cursor ab: einen Cast aus einem Ordner, FBX für jeden Kopf, ein Pipeline-Skript.
Mit KI-Agenten nutzen
Technical Artists
Öffnen Sie MetaHuman Creator, wenn Angleichung, Haut und Grooms schon feststehen.
Inhalt eines Kopfs0,01 $ pro Credit, egal auf welchem Weg.
Die API, Ihr Agent und die Web-App greifen auf ein Guthaben zum selben Preis zu. Kaufen Sie Credits im Paket oder in beliebiger Menge, ohne Abo. Ein Kopf kostet 1.500 Credits, und wenn er fehlschlägt, kommen seine Credits von selbst zurück. Wo Sales Tax oder Mehrwertsteuer anfallen, werden sie beim Bezahlen hinzugerechnet.
Ein Kopf, im Browser.
Sie brauchen weder einen Agenten noch einen API-Schlüssel. Melden Sie sich mit Google an, laden Sie ein bis 15 Fotos einer Person hoch und laden Sie den Kopf in etwa 4 Minuten herunter. Die Web-App zeigt vor dem Download die 3D-Vorschau mit Mimik und Haaren.
Bevor Sie automatisieren.
- 01Muss ich Code schreiben?
- Nein. Fügen Sie einen Prompt in einen KI-Agenten wie Claude Code oder Cursor ein oder nutzen Sie die Web-App im Browser. Mit KI-Agenten nutzen
- 02Wie lange braucht ein Kopf?
- Etwa 4 Minuten ab dem Upload. Wenn viele Köpfe warten, reiht sich Ihrer ein, und die API meldet seinen Platz in der Warteschlange.
- 03Wie viele Fotos brauche ich?
- Ein scharfes Foto genügt. Bis zu 15 Fotos derselben Person helfen, besonders ein Profil und eine Dreiviertelansicht. Foto-Tipps
- 04Was passiert, wenn ein Kopf fehlschlägt?
- Seine 1.500 Credits gehen von selbst auf Ihr Guthaben zurück, und
error.codenennt den Grund, zum Beispielno_face. - 05Gehören die Haare zum Kopf?
- Nein. In MetaHuman sind Haare, Brauen und Bärte Grooms. Wir empfehlen die passenden samt Farben, als Daten, die Ihre Tools lesen können.
- 06Wessen Fotos darf ich verwenden?
- Ihre eigenen oder Fotos einer erwachsenen Person, die damit einverstanden ist, dass ein 3D-Kopf von ihr erstellt wird. Wir erstellen keine Köpfe von Kindern und keine aus Fotos, die im Internet gefunden wurden. Zulässige Nutzung EN
- 07Was passiert mit meinen Fotos?
- Sie werden nach 30 Tagen gelöscht, und Sie können einen Kopf samt Fotos auch früher löschen. Datenschutzerklärung EN
Ihr erster Kopf ist einen Prompt entfernt.
Konto erstellen, Credits kaufen, den Prompt einfügen und den Code freigeben.