3D-Köpfe aus Claude Code, Codex oder Cursor erstellen.

Der erste Durchlauf, Schritt für Schritt

1. Einen Prompt einfügen

   Öffnen Sie Ihren Agenten im Ordner mit Ihrem Foto und fügen Sie das hier ein. Es funktioniert in jedem Agenten, der einen Shell-Befehl ausführen oder eine URL abrufen kann; die Seite zu KI-Agenten hat eine Version für jeden.

   Prompt · EnglischKopieren

   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.

2. Den Anmeldecode freigeben

   Der Agent zeigt Ihnen einen kurzen Code und öffnet faceninja.net/device. Dort melden Sie sich an und geben den Code frei. Kein API-Schlüssel wird in den Chat eingefügt; der Skill bewahrt seinen Schlüssel auf Ihrem Computer auf und gibt ihn nie aus.

3. Bestätigen, dass Sie die Fotos verwenden dürfen

   Vor dem ersten Kopf zeigt Ihnen der Agent eine Erklärung, die Sie mit eigenen Worten bestätigen: Sie haben das Recht, die Fotos zu verwenden, und die Einwilligung jeder abgebildeten Person, alle sind erwachsen, und Sie halten die Richtlinie zu Inhalten und Persönlichkeitsrechten EN ein. Der Agent bestätigt das nie für Sie.

4. Der Agent nennt zuerst die Kosten

   Er prüft Ihr Guthaben und sagt Ihnen, was ein Kopf kostet und was übrig bleibt, bevor er etwas ausgibt. Bei mehr als fünf Köpfen hält er an und bittet Sie, die Gesamtsumme zu bestätigen.

5. Die kostenlosen Beispiele ausprobieren

   Auch ganz ohne Credits kann der Agent die 20 Beispielköpfe herunterladen, sodass Sie zuerst den Rest Ihrer Pipeline testen können.

6. Ein Kopf, dann ein Ordner

   Für einen Cast legen Sie die Fotos jeder Person in einen eigenen Unterordner und fügen den Cast-Prompt ein. Der Agent zählt die Köpfe, nennt die Gesamtsumme und wartet auf Ihr Ja.

   Prompt · EnglischKopieren

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

   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.

Was der Skill ausführt

Der Skill ist eine einzige Python-Datei ohne zu installierende Pakete (Python 3.9 oder neuer). Ihr Agent führt sie aus; Sie können das auch. Das ist ihre eigene Hilfe, unbearbeitet:

$ python3 faceninja.py --help
usage: faceninja.py [-h] [--json] [--base BASE] [--version] COMMAND ...

FaceNinja: photos in, MetaHuman head out.

positional arguments:
  COMMAND
    login      sign in by approving a code in the browser
    whoami     who is signed in
    balance    credits left and what a head costs
    make       make one head from 1-15 photos of one person
    status     where a head stands
    download   download a finished head's files
    batch      one head per photo, or per subfolder with --per-person-
               subfolders
    samples    the free sample heads: list them, or --download ID|all (no
               credits)
    list       your heads, newest first
    logout     revoke and forget the saved key
    update     update the skill now (it also updates itself at most hourly)
    guidance   the server's current rules and notices for agents
    attest     the user confirms, once per computer, that they may use the
               photos (asked before the first head)

options:
  -h, --help   show this help message and exit
  --json       one JSON object on stdout, progress on stderr
  --base BASE  API server (default $FACENINJA_API_BASE or
               https://faceninja.net)
  --version    show program's version number and exit

Was der Agent kann und was nicht

• Köpfe aus 1–15 Fotos einer Person erstellen, ein Kopf pro Unterordner, und GLB, FBX, OBJ, STL, PLY oder das MetaHuman ZIP herunterladen.
• Ihr Guthaben prüfen, Ihre Köpfe auflisten und erneut herunterladen.
• Ein Pipeline-Skript mit Idempotenzschlüsseln und einem Webhook-Handler schreiben, auf Basis von llms.txt und dem Skill.

• Credits kaufen oder automatisches Aufladen einschalten: Dafür schickt er Sie in die Web-App.
• Die Einwilligung bestätigen oder eine Anmeldung für Sie freigeben.
• Köpfe von Kindern, von Personen des öffentlichen Lebens oder aus Fotos aus dem Internet erstellen.

Fragen zu Köpfen von KI-Agenten

01Welche Agenten funktionieren?

Claude Code, Codex, Cursor, Gemini CLI und OpenClaw sowie jeder Agent, der einen Shell-Befehl ausführen oder eine URL abrufen kann.

02Füge ich einen API-Schlüssel in den Chat ein?

Nein. Sie geben in Ihrem Browser einen Code frei, und der Skill bewahrt den Schlüssel auf Ihrem Computer auf. Er gibt ihn nie aus.

03Kann der Agent ohne Nachfrage Credits ausgeben?

Er nennt Ihnen vor jedem Auftrag die Kosten und Ihr Guthaben und wartet ab fünf Köpfen auf Ihre Bestätigung.

04Gibt es einen MCP-Server?

Derzeit nicht. Der Skill arbeitet über ein Kommandozeilen-Skript, das Agenten direkt ausführen.