FaceNinja
Русский
Создать аккаунт

ИИ-агенты · Claude Code, Codex, Cursor, Gemini CLI, OpenClaw

Головы может делать ваш ИИ-агент.

Вставьте один промпт в Claude Code, Codex, Cursor, Gemini CLI или OpenClaw. Агент прочитает наш навык, установит его, войдёт в аккаунт по коду, который вы подтвердите, и сделает голову MetaHuman по вашему фото. Копировать ключ не нужно. Примерно через 4 минуты GLB и MetaHuman ZIP лежат в вашей папке.

Промпт по умолчанию
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.

Замените ./photo.jpg на путь к вашему фото. Остальное оставьте на английском: агенту нужен URL точно в таком виде.

Создать аккаунтЧитать SKILL.md
  • 0,01 $ за кредит, оплата по мере использования
  • 1 500 кредитов за голову, все файлы включены
  • Навык спрашивает, прежде чем тратить
Три момента запуска

  1. Агент выводит код вроде WXYZ-2345 и ссылку faceninja.net/device.

  2. Вы открываете /device, войдя в аккаунт, сверяете код и нажимаете Разрешить.

  3. Агент называет стоимость и ваш баланс, затем сохраняет GLB и MetaHuman ZIP.

Аккаунт, промпт, код.

  1. Создайте аккаунт.

    Создайте аккаунт на faceninja.net через Google или по e-mail и купите кредиты на запланированные головы. Навык называет стоимость, прежде чем что-либо потратить.

    Создать аккаунт

  2. Вставьте промпт.

    Откройте агента в папке с вашим фото и вставьте промпт выше. Агент загрузит SKILL.md, установит навык и запустит его CLI.

  3. Подтвердите код.

    Агент покажет короткий код. Откройте faceninja.net/device, войдя в аккаунт, проверьте, что код совпадает, и подтвердите. Дальше агент работает сам.

Ключ копировать не нужно. Если всё же хотите использовать ключ, создайте ключ API в веб-приложении и задайте его как FACENINJA_API_KEY; навык возьмёт его и пропустит код.

Промпты для реальных задач.

В каждом промпте указан URL навыка, поэтому он работает в новой сессии без установки. Замените пути на свои. Промпты остаются на английском во всех языковых версиях этого сайта, потому что агент должен читать URL и имена файлов в точности. Потом с агентом всё равно можно общаться на своём языке.

01 · Одна голова по одному фото Базовый

Ваша первая голова или быстрый тест.

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

Оставьте этот промпт на английском: агенту нужен веб-адрес точно в таком виде. Потом можно общаться с ним на своём языке.

02 · Группа людей из папки

Одна подпапка на человека, в каждой от 1 до 15 фото.

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

Если голов больше 5, навык всегда останавливается и ждёт вашего согласия. Навык устроен именно так; промпт лишь проговаривает это явно. Оставьте этот промпт на английском: агенту нужен веб-адрес точно в таком виде. Потом можно общаться с ним на своём языке.

03 · FBX для уже созданных голов

Повторная загрузка в другом формате. Ничего нового не создаётся и не списывается.

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

Файлы доступны в течение 30 дней после готовности головы. Оставьте этот промпт на английском: агенту нужен веб-адрес точно в таком виде. Потом можно общаться с ним на своём языке.

04 · Скрипт пайплайна с webhook

Агент пишет интеграцию; вы проверяете её и запускаете.

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

Оставьте этот промпт на английском: агенту нужен веб-адрес точно в таком виде. Потом можно общаться с ним на своём языке.

05 · Проверить баланс

Перед большой задачей или когда запуск остановился.

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

Оставьте этот промпт на английском: агенту нужен веб-адрес точно в таком виде. Потом можно общаться с ним на своём языке.

Куда вставлять.

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

Откройте терминал в папке проекта, выполните claude и вставьте промпт.

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

Оставьте этот промпт на английском: агенту нужен веб-адрес точно в таком виде. Потом можно общаться с ним на своём языке.

Или сначала установите навык для этого агента, а потом попросите:

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

Устанавливается в ~/.claude/skills/faceninja (или $CLAUDE_CONFIG_DIR/skills). Новые сессии подхватывают его сами.

Claude Code, Codex, Cursor, Gemini CLI и OpenClaw — товарные знаки их владельцев. FaceNinja не связан с ними.

Или сначала установите навык.

Быстрее всего попросить агента прочитать SKILL.md. Если вы предпочитаете установить навык сами или ваш агент не умеет загружать URL, используйте один из этих вариантов.

macOS и Linux

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

Windows (PowerShell)

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

ZIP

Скачайте навык и распакуйте его там, где ваш агент хранит навыки.

Скачать ZIP

Сначала прочесть

SKILL.md — обычный текст. Прочитайте его или попросите агента пересказать, прежде чем что-либо запускать.

Открыть файл

Читайте скрипт, прежде чем отправлять его в оболочку. Оба установщика короткие; откройте install.sh EN или install.ps1 EN, чтобы увидеть, что они делают.

Что нужно: Python 3 для CLI (это один файл без зависимостей) и подключение к интернету. Больше ничего не устанавливается.

Для агентов, которые читают только веб: https://faceninja.net/llms.txt перечисляет документацию, файл OpenAPI и навык в форме, удобной для языковых моделей.

О чём может попросить ваш агент.

Навык — тонкая надстройка над API FaceNinja. Ваш агент может всё, что умеет API, а перечисленные ниже проверки уже встроены.

Войти в аккаунт

По коду, который вы подтверждаете на faceninja.net/device, или через FACENINJA_API_KEY.

Создавать головы

По 1–15 фото одного человека: одну голову или целую папку людей.

Дожидаться результата

Голова делается около 4 минут. Навык ждёт, пока она не будет готова или не завершится ошибкой.

Скачивать любой формат

GLB, FBX, OBJ, STL, PLY или MetaHuman ZIP, с 52 формами ARKit или без них.

Забирать прежние головы

Скачать другой формат уже созданной головы, пока хранятся её файлы (30 дней).

Показывать баланс

Сколько кредитов осталось и на сколько голов их хватит.

Каждая голова, которую делает навык, — полноценная голова FaceNinja: карты кожи 4K, рекомендации по groom (волосам MetaHuman), подогнанная шея и 52 формы ARKit. Что в 3D-голове

Он спрашивает, прежде чем тратить.

  • Сначала стоимость. Перед любой головой навык сообщает, сколько она стоит и сколько останется на балансе.
  • Пакетные запуски ждут вашего согласия. Если голов больше 5 за раз, навык останавливается и спрашивает.
  • За неудачные головы кредиты возвращаются. Если голова не удалась, её 1 500 кредитов сами возвращаются на ваш баланс, а ошибка объясняет причину.
  • Ключа нет в вашем чате. Вход по коду даёт навыку доступ, и ключ ни разу не появляется ни в вашем промпте, ни в истории. Каждый новый вход вы подтверждаете сами.
  • Потолок выбираете вы. Навык может потратить только купленные вами кредиты. Подписки нет, отменять нечего.
  • Фото удаляются через 30 дней. CLI загружает их с вашего диска в FaceNinja. Смотрит ли на них ещё и ваш агент, зависит от агента и вашего промпта.
  • Только лица тех, кто согласился. Используйте фото себя или взрослых, которые согласились. Никаких детей и никаких фото из интернета. Допустимое использование EN

Вопросы об агентах.

01Нужен ли ключ API?
Нет. Агент показывает код, а вы подтверждаете его на faceninja.net/device. Если ваша среда не может показать код, например серверная задача, создайте ключ API в веб-приложении и задайте FACENINJA_API_KEY.
02С какими агентами это работает?
С Claude Code, Codex, Cursor, Gemini CLI и OpenClaw, а также с любым агентом, который умеет выполнять команды оболочки или загружать URL.
03Сколько стоит навык?
Ничего. Голова стоит 1 500 кредитов (15 $), как и в веб-приложении и через API.
04Можно ли писать промпт на своём языке?
Да, вокруг URL. Оставьте https://faceninja.net/skill/SKILL.md и пути к файлам в точности как есть, а остальное агент поймёт на любом языке, который он знает.
05Может ли агент построить целый пайплайн?
Да. Промпт 4 выше просит написать его с webhook и ключами идемпотентности. Страница Разработчикам и справочник API EN написаны так, чтобы их мог прочитать и агент.
06Есть ли сервер MCP?
Сегодня нет. Навык и llms.txt покрывают перечисленных выше агентов. Напишите нам, если ваш агент работает только с MCP.
07Видит ли агент мои фото?
CLI навыка загружает их прямо с вашего диска. Агент видит имена файлов и результаты. Если вы попросите его посмотреть на фото, он посмотрит — через своего провайдера.
08Куда попадают файлы?
Куда скажет ваш промпт. Промпт по умолчанию использует ./faceninja-out.

Идём дальше.

API

Webhook, ключи идемпотентности и пакетная обработка — когда пайплайн работает без агента.

Разработчикам

Справочник

Каждый эндпоинт, поле и ошибка, плюс файл OpenAPI 3.1.

Справочник API EN

Одна голова, без кода

Вместо этого загрузите фото в браузере.

Открыть приложение

Один промпт. Одна готовая голова.

Создать аккаунт