FaceNinja

Οδηγός · Claude Code · Codex · Cursor · Gemini CLI · OpenClaw

Φτιάξτε 3D κεφάλια από Claude Code, Codex ή Cursor.

Ο AI coding agent σας φτιάχνει κεφάλια MetaHuman: ένα από φωτογραφία, θίασο από φάκελο, FBX για όλα τα κεφάλια σας ή σενάριο για τη ροή εργασίας. Ο οδηγός καλύπτει την πρώτη εκτέλεση, όσα ρωτά ο agent και τι μπορεί ή δεν μπορεί να κάνει.

Η πρώτη εκτέλεση, βήμα προς βήμα

  1. Επικολλήστε ένα prompt

    Ανοίξτε τον agent στον φάκελο της φωτογραφίας και επικολλήστε το παρακάτω. Λειτουργεί με agent που εκτελεί εντολή shell ή ανακτά URL· η σελίδα agents έχει έκδοση για καθέναν.

    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.

    Αφήστε αυτό το prompt στα αγγλικά: ο agent σας χρειάζεται τη διεύθυνση ακριβώς όπως είναι γραμμένη. Μετά μπορείτε να του μιλάτε στη γλώσσα σας.

  2. Εγκρίνετε τον κωδικό σύνδεσης

    Ο agent δείχνει σύντομο κωδικό και ανοίγει το faceninja.net/device. Συνδέεστε εκεί και εγκρίνετε τον κωδικό. Δεν επικολλάται κλειδί API στη συνομιλία· το skill το κρατά στον υπολογιστή σας και δεν το εμφανίζει ποτέ.

  3. Επιβεβαιώστε το δικαίωμα χρήσης φωτογραφιών

    Πριν το πρώτο κεφάλι ο agent δείχνει δήλωση για επιβεβαίωση με δικά σας λόγια: δικαιούστε να χρησιμοποιείτε τις φωτογραφίες, κάθε άτομο έχει συναινέσει, όλοι είναι ενήλικοι και τηρείτε την Πολιτική περιεχομένου και ομοιότητας EN. Ο agent δεν επιβεβαιώνει για εσάς.

  4. Ο agent αναφέρει πρώτα το κόστος

    Ελέγχει το υπόλοιπο και σας λέει κόστος κεφαλιού και τι απομένει πριν ξοδέψει. Για πάνω από πέντε κεφάλια σταματά και ζητά επιβεβαίωση του συνόλου.

  5. Δοκιμάστε τα δωρεάν δείγματα

    Χωρίς καθόλου credits, ο agent κατεβάζει τα 20 δείγματα κεφαλιών, για να δοκιμάσετε πρώτα την υπόλοιπη ροή σας.

  6. Ένα κεφάλι και μετά ένας φάκελος

    Για θίασο, βάλτε τις φωτογραφίες κάθε ατόμου σε ξεχωριστό υποφάκελο και επικολλήστε το prompt θιάσου. Ο agent μετρά τα κεφάλια, αναφέρει σύνολο και περιμένει το ναι σας.

    Prompt · Αγγλικά
    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>.

    Αφήστε αυτό το prompt στα αγγλικά: ο agent σας χρειάζεται τη διεύθυνση ακριβώς όπως είναι γραμμένη. Μετά μπορείτε να του μιλάτε στη γλώσσα σας.

Τι εκτελεί το skill

Το skill είναι ένα αρχείο Python χωρίς πακέτα προς εγκατάσταση (Python 3.9 ή νεότερο). Το εκτελεί ο agent· μπορείτε κι εσείς. Αυτή είναι η βοήθειά του, χωρίς αλλαγές:

Shell
$ 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

Τι μπορεί και τι δεν μπορεί ο agent

  • Φτιάχνει κεφάλια από 1–15 φωτογραφίες ενός ατόμου, ένα ανά υποφάκελο, και κατεβάζει GLB, FBX, OBJ, STL, PLY ή MetaHuman ZIP.
  • Ελέγχει υπόλοιπο, παραθέτει κεφάλια και τα κατεβάζει ξανά.
  • Γράφει σενάριο ροής με κλειδιά idempotency και χειριστή webhook, από το llms.txt και το skill.
  • Να αγοράσει credits ή να ενεργοποιήσει αυτόματη αναπλήρωση: σας στέλνει στην εφαρμογή web.
  • Να επιβεβαιώσει συναίνεση ή να εγκρίνει σύνδεση για εσάς.
  • Να φτιάξει κεφάλια παιδιών, δημόσιων προσώπων ή από φωτογραφίες του διαδικτύου.

Ερωτήσεις για κεφάλια από AI agents

01Ποιοι agents λειτουργούν;
Claude Code, Codex, Cursor, Gemini CLI και OpenClaw και κάθε agent που μπορεί να εκτελέσει εντολή shell ή να ανακτήσει URL.
02Επικολλώ κλειδί API στη συνομιλία;
Όχι. Εγκρίνετε κωδικό στον browser και το skill κρατά το κλειδί στον υπολογιστή σας. Δεν το εμφανίζει ποτέ.
03Μπορεί ο agent να ξοδεύει χωρίς να ρωτήσει;
Λέει κόστος και υπόλοιπο πριν κάθε εργασία και σταματά για επιβεβαίωση πάνω από πέντε κεφάλια.
04Υπάρχει διακομιστής MCP;
Όχι σήμερα. Το skill λειτουργεί μέσω σεναρίου γραμμής εντολών που εκτελούν απευθείας οι agents.

Φτιάξτε MetaHuman από τη δική σας φωτογραφία.

Εγγραφείτε δωρεάν, κατεβάστε τα δείγματα και φτιάξτε κεφάλια από δικές σας φωτογραφίες όταν ανοίξουν τα επί πληρωμή πλάνα.