FaceNinja

Посібник · Claude Code · Codex · Cursor · Gemini CLI · OpenClaw

Створюйте 3D-голови з Claude Code, Codex чи Cursor.

Ваш ШІ-агент програмування може створювати голови MetaHuman: одну з фото, цілий склад із теки, FBX усіх ваших голів чи скрипт для конвеєра. Посібник пояснює перший запуск, що запитає агент і що він може й не може.

Перший запуск, крок за кроком

  1. Вставте один промпт

    Відкрийте агента в теці з фото й вставте це. Працює з будь-яким агентом, що виконує команди оболонки чи завантажує URL; на сторінці агентів є варіант для кожного.

    Промпт · англійською
    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.

    Залиште цей промпт англійською: агентові потрібна вебадреса саме в такому вигляді. Потім можна спілкуватися з ним своєю мовою.

  2. Схваліть код входу

    Агент показує короткий код і відкриває faceninja.net/device. Увійдіть там і схваліть код. Ключ API не вставляється в чат; навичка зберігає його на комп'ютері й ніколи не виводить.

  3. Підтвердьте право використовувати фото

    Перед першою головою агент показує заяву для підтвердження власними словами: ви маєте право на фото й згоду кожної людини, вони дорослі, і ви дотримуєтесь Політики вмісту та подоби EN. Агент ніколи не підтверджує це за вас.

  4. Агент спершу називає вартість

    Він перевіряє баланс і повідомляє вартість голови та залишок до витрат. Для понад п'яти голів зупиняється й просить підтвердити загальну суму.

  5. Спробуйте безплатні зразки

    Навіть без кредитів агент може завантажити 20 зразків 3D-голів, щоб спершу перевірити решту конвеєра.

  6. Одна 3D-голова, потім тека

    Для складу покладіть фото кожної людини в окрему підтеку й вставте промпт складу. Агент рахує голови, називає суму й чекає вашої згоди.

    Промпт · англійською
    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>.

    Залиште цей промпт англійською: агентові потрібна вебадреса саме в такому вигляді. Потім можна спілкуватися з ним своєю мовою.

Що запускає навичка

Навичка — один файл Python без установлення пакетів (Python 3.9 чи новіший). Агент запускає його; ви теж можете. Ось його власна довідка без змін:

Оболонка
$ 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

Що агент може й не може робити

  • Створювати 3D-голови з 1–15 фото однієї людини, по голові на підтеку, і завантажувати GLB, FBX, OBJ, STL, PLY чи MetaHuman ZIP.
  • Перевіряти баланс, показувати список голів і завантажувати їх знову.
  • Писати скрипт конвеєра з ключами ідемпотентності й обробником webhook за llms.txt і навичкою.
  • Купувати кредити чи вмикати автоматичне поповнення: натомість скеровує до вебзастосунку.
  • Підтверджувати згоду чи схвалювати вхід за вас.
  • Створювати голови дітей, публічних осіб або з фото, знайдених онлайн.

Запитання про 3D-голови від ШІ-агентів

01Які агенти працюють?
Claude Code, Codex, Cursor, Gemini CLI й OpenClaw, а також будь-який агент, що виконує команду оболонки чи завантажує URL.
02Чи треба вставляти ключ API в чат?
Ні. Ви схвалюєте код у браузері, а навичка зберігає ключ на комп'ютері. Вона ніколи його не виводить.
03Чи може агент витрачати без запиту?
Він повідомляє вартість і баланс перед кожним завданням, а для понад п'яти голів чекає підтвердження.
04Чи є сервер MCP?
Наразі ні. Навичка працює через скрипт командного рядка, який агенти запускають напряму.

Зробіть MetaHuman зі свого фото.

Зареєструйтеся безкоштовно, завантажте зразки голів і робіть голови з власних фото, коли відкриються платні плани.