3D-головы из Claude Code, Codex или Cursor.

Первый запуск, шаг за шагом

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

   Откройте агента в папке с вашим фото и вставьте это. Работает в любом агенте, который умеет выполнять команды shell или загружать 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 примеров голов, чтобы сначала проверить остальной пайплайн.

6. Одна голова, потом папка

   Для каста положите фото каждого человека в отдельную подпапку и вставьте промпт для каста. Агент посчитает головы, назовёт итог и дождётся вашего «да».

   Промпт · английскийКопия промпта

   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

Что агент может и чего не может

• Делать головы по 1–15 фото одного человека, по одной голове на подпапку, и скачивать GLB, FBX, OBJ, STL, PLY или MetaHuman ZIP.
• Проверять баланс, показывать список голов и скачивать их снова.
• Написать скрипт пайплайна с ключами идемпотентности и обработчиком webhook по llms.txt и навыку.

• Покупать кредиты или включать автопополнение: вместо этого он отправит вас в веб-приложение.
• Подтверждать согласие или вход за вас.
• Делать головы детей, публичных людей или по фото из интернета.

Вопросы о головах через ИИ-агентов

01Какие агенты работают?

Claude Code, Codex, Cursor, Gemini CLI и OpenClaw, а также любой агент, который умеет выполнять команды shell или загружать URL.

02Нужно ли вставлять ключ API в чат?

Нет. Вы подтверждаете код в браузере, а навык хранит ключ на вашем компьютере. Он никогда его не выводит.

03Может ли агент тратить без спроса?

Перед каждым заданием он называет стоимость и ваш баланс, а если голов больше пяти, ждёт вашего подтверждения.

04Есть ли MCP-сервер?

Пока нет. Навык работает через скрипт командной строки, который агенты запускают напрямую.