FaceNinja

KI-Agenten · Claude Code, Codex, Cursor, Gemini CLI, OpenClaw

Ihr KI-Agent kann die Köpfe erstellen.

Fügen Sie einen Prompt in Claude Code, Codex, Cursor, Gemini CLI oder OpenClaw ein. Ihr Agent liest unseren Skill, installiert ihn, meldet Sie mit einem Code an, den Sie freigeben, und erstellt aus Ihrem Foto einen MetaHuman-Kopf. Kein Schlüssel zum Kopieren. Etwa 4 Minuten später liegen die GLB-Datei und das MetaHuman ZIP in Ihrem Ordner.

Standard-Prompt
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.

Ersetzen Sie ./photo.jpg durch den Pfad Ihres Fotos. Lassen Sie den Rest auf Englisch: Der Agent braucht die URL genau so, wie sie dasteht.

  • 0,01 $ pro Credit, nach Bedarf bezahlen
  • 1.500 Credits pro Kopf, alle Dateien inklusive
  • Der Skill fragt nach, bevor er Credits ausgibt
Drei Momente eines Durchlaufs
  1. Ihr Agent gibt einen Code wie WXYZ-2345 und den Link faceninja.net/device aus.

  2. Sie öffnen /device, während Sie angemeldet sind, prüfen den Code und klicken auf Freigeben.

  3. Ihr Agent nennt die Kosten und Ihr Guthaben und speichert dann die GLB-Datei und das MetaHuman ZIP.

Konto, Prompt, Code.

  1. Konto erstellen.

    Erstellen Sie auf faceninja.net ein Konto mit Google oder Ihrer E-Mail-Adresse und kaufen Sie die Credits für die geplanten Köpfe. Der Skill nennt Ihnen die Kosten, bevor er etwas ausgibt.

    Konto erstellen

  2. Prompt einfügen.

    Öffnen Sie Ihren Agenten in dem Ordner, der Ihr Foto enthält, und fügen Sie den Prompt von oben ein. Der Agent ruft SKILL.md ab, installiert den Skill und führt dessen CLI aus.

  3. Code freigeben.

    Der Agent zeigt Ihnen einen kurzen Code. Öffnen Sie faceninja.net/device, während Sie angemeldet sind, prüfen Sie, ob der Code übereinstimmt, und geben Sie ihn frei. Der Agent macht danach von selbst weiter.

Sie kopieren nie einen Schlüssel. Wenn Sie lieber einen verwenden möchten, erstellen Sie in der Web-App einen API-Schlüssel und setzen Sie ihn als FACENINJA_API_KEY; der Skill nutzt ihn und überspringt den Code.

Prompts für echte Aufgaben.

Jeder Prompt nennt die URL des Skills und funktioniert deshalb in einer frischen Sitzung ohne Installation. Ersetzen Sie die Pfade durch Ihre eigenen. Die Prompts bleiben in jeder Sprachversion dieser Website auf Englisch, weil der Agent die URLs und Dateinamen genau lesen muss. Danach können Sie trotzdem in Ihrer eigenen Sprache mit Ihrem Agenten sprechen.

01 · Ein Kopf aus einem Foto Standard

Ihr erster Kopf oder ein schneller Test.

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

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.

02 · Ein Cast aus einem Ordner

Ein Unterordner pro Person, je 1 bis 15 Fotos.

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

Ein Cast mit mehr als 5 Köpfen hält immer an und wartet auf Ihr Ja. So ist der Skill gebaut; der Prompt macht es nur ausdrücklich. 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.

03 · FBX für bereits erstellte Köpfe

Noch einmal in einem anderen Format herunterladen. Es wird nichts Neues erstellt oder berechnet.

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

Die Dateien bleiben nach Fertigstellung eines Kopfs 30 Tage lang verfügbar. 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.

04 · Ein Webhook-Pipeline-Skript

Ihr Agent schreibt die Integration; Sie prüfen sie und führen sie aus.

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

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.

05 · Guthaben prüfen

Vor einem großen Auftrag oder wenn ein Lauf angehalten hat.

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

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.

Wo Sie ihn einfügen.

In jedem davon funktioniert derselbe Prompt. Nur die Stelle, an der Sie ihn einfügen, ist verschieden.

Öffnen Sie ein Terminal in Ihrem Projektordner, führen Sie claude aus und fügen Sie den Prompt ein.

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

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.

Oder installieren Sie zuerst den Skill für diesen Agenten und fragen Sie dann:

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

Wird nach ~/.claude/skills/faceninja installiert (oder nach $CLAUDE_CONFIG_DIR/skills). Neue Sitzungen laden ihn von selbst.

Claude Code, Codex, Cursor, Gemini CLI und OpenClaw sind Marken ihrer jeweiligen Inhaber. FaceNinja steht in keiner Verbindung zu ihnen.

Oder den Skill zuerst installieren.

Den Agenten SKILL.md lesen zu lassen, ist der schnellste Weg. Wenn Sie den Skill lieber selbst installieren oder Ihr Agent keine URLs abrufen kann, nutzen Sie eine dieser Möglichkeiten.

macOS und Linux

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

Windows (PowerShell)

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

ZIP

Laden Sie den Skill herunter und entpacken Sie ihn dort, wo Ihr Agent Skills ablegt.

ZIP-Download

Zuerst lesen

SKILL.md ist reiner Text. Lesen Sie die Datei oder lassen Sie sie von Ihrem Agenten zusammenfassen, bevor Sie etwas ausführen.

SKILL.md lesen

Lesen Sie ein Skript, bevor Sie es per Pipe in eine Shell leiten. Beide Installer sind kurz: Öffnen Sie install.sh EN oder install.ps1 EN, um zu sehen, was sie tun.

Was Sie brauchen: Python 3 für die CLI, die aus einer einzigen Datei ohne Abhängigkeiten besteht, und eine Internetverbindung. Sonst wird nichts installiert.

Für Agenten, die nur das Web lesen: https://faceninja.net/llms.txt listet die Dokumentation, die OpenAPI-Datei und den Skill in einer Form auf, die Sprachmodelle gut lesen können.

Was Ihr Agent anfordern kann.

Der Skill ist eine dünne Schicht über der FaceNinja-API. Ihr Agent kann alles, was die API kann, mit den folgenden eingebauten Prüfungen.

Sie anmelden

Mit einem Code, den Sie unter faceninja.net/device freigeben, oder mit FACENINJA_API_KEY.

Köpfe erstellen

Aus je 1 bis 15 Fotos einer Person, ein Kopf oder ein ganzer Ordner voller Personen.

Auf sie warten

Ein Kopf braucht etwa 4 Minuten. Der Skill wartet, bis er fertig ist oder fehlgeschlagen ist.

Jedes Format herunterladen

GLB, FBX, OBJ, STL, PLY oder das MetaHuman ZIP, mit oder ohne die 52 ARKit-Blendshapes.

Frühere Köpfe abrufen

Ein anderes Format eines bereits erstellten Kopfs herunterladen, solange seine Dateien aufbewahrt werden (30 Tage).

Ihr Guthaben anzeigen

Verbleibende Credits und wie viele Köpfe sie bezahlen.

Jeder Kopf, den der Skill erstellt, ist ein vollständiger FaceNinja-Kopf: 4K-Hautmaps, Groom-Empfehlungen (MetaHuman-Haar), ein passender Hals und 52 ARKit-Blendshapes. Inhalt eines Kopfs

Der Skill fragt, bevor er Credits ausgibt.

  • Erst die Kosten. Vor jedem Kopf nennt der Skill, was er kostet und was auf Ihrem Guthaben übrig ist.
  • Batches warten auf ein Ja. Bei mehr als 5 Köpfen auf einmal hält der Skill an und fragt nach.
  • Fehlgeschlagene Köpfe werden erstattet. Wenn ein Kopf fehlschlägt, gehen seine 1.500 Credits von selbst auf Ihr Guthaben zurück, und der Fehler nennt den Grund.
  • Kein Schlüssel in Ihrem Chat. Die Anmeldung per Code gibt dem Skill Zugriff, ohne dass je ein Schlüssel in Ihrem Prompt oder Ihrem Verlauf auftaucht. Jede neue Anmeldung geben Sie selbst frei.
  • Sie legen die Obergrenze fest. Der Skill kann nur Credits ausgeben, die Sie gekauft haben. Es gibt kein Abo und nichts zu kündigen.
  • Fotos werden nach 30 Tagen gelöscht. Die CLI lädt sie von Ihrer Festplatte zu FaceNinja hoch. Ob Ihr Agent sie sich auch ansieht, hängt vom Agenten und von Ihrem Prompt ab.
  • Nur Gesichter, die Ja gesagt haben. Nutzen Sie Fotos von sich selbst oder von Erwachsenen, die eingewilligt haben. Keine Kinder, keine Fotos aus dem Internet. Zulässige Nutzung EN

Fragen zu Agenten.

01Brauche ich einen API-Schlüssel?
Nein. Der Agent zeigt Ihnen einen Code, den Sie unter faceninja.net/device freigeben. Wenn Ihr Setup Ihnen keinen Code anzeigen kann, zum Beispiel bei einem Server-Job, erstellen Sie in der Web-App einen API-Schlüssel und setzen Sie FACENINJA_API_KEY.
02Mit welchen Agenten funktioniert er?
Mit Claude Code, Codex, Cursor, Gemini CLI und OpenClaw sowie mit jedem Agenten, der einen Shell-Befehl ausführen oder eine URL abrufen kann.
03Was kostet der Skill?
Nichts. Ein Kopf kostet 1.500 Credits (15 $), genauso wie in der Web-App und der API.
04Kann ich den Prompt in meiner eigenen Sprache schreiben?
Ja, um die URLs herum. Lassen Sie https://faceninja.net/skill/SKILL.md und Ihre Dateipfade genau so, wie sie sind; den Rest befolgt der Agent in jeder Sprache, die er versteht.
05Kann mein Agent eine ganze Pipeline bauen?
Ja. Prompt 4 oben bittet ihn, eine mit Webhooks und Idempotenzschlüsseln zu schreiben. Die Seite Entwickler und die API-Referenz EN sind so geschrieben, dass auch ein Agent sie lesen kann.
06Gibt es einen MCP-Server?
Derzeit nicht. Der Skill und llms.txt decken die oben genannten Agenten ab. Schreiben Sie uns, wenn Ihr Agent nur MCP spricht.
07Sieht der Agent meine Fotos?
Die CLI des Skills lädt sie direkt von Ihrer Festplatte hoch. Ihr Agent sieht die Dateinamen und die Ergebnisse. Wenn Sie ihn bitten, sich ein Foto anzusehen, tut er das über seinen eigenen Anbieter.
08Wohin gehen die Dateien?
Dorthin, wo Ihr Prompt es sagt. Der Standard-Prompt nutzt ./faceninja-out.

Wie es weitergeht.

Die API

Webhooks, Idempotenzschlüssel und Batches, für den Fall, dass die Pipeline ohne Agent läuft.

Entwickler

Die Referenz

Jeder Endpunkt, jedes Feld und jeder Fehler, dazu eine OpenAPI-3.1-Datei.

API-Referenz EN

Ein Kopf, ohne Code

Laden Sie stattdessen im Browser ein Foto hoch.

Web-App öffnen

Ein Prompt. Ein fertiger Kopf.