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 на шлях до вашого фото. Решту лишіть англійською: агентові потрібна адреса точно в такому вигляді.

  • 0,01 USD за кредит, оплата за використання
  • 1 500 кредитів за голову, усі файли включено
  • Навичка питає, перш ніж витрачати
Три моменти запуску
  1. Агент виводить код на кшталт WXYZ-2345 і посилання faceninja.net/device.

  2. Ви відкриваєте /device, увійшовши в акаунт, звіряєте код і натискаєте Схвалити.

  3. Агент називає вартість і ваш баланс, а потім зберігає GLB і MetaHuman ZIP.

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

  1. Створіть акаунт.

    Зареєструйтеся на faceninja.net через Google або електронну пошту й купіть кредити на заплановані голови. Навичка називає вартість, перш ніж щось витратити.

    Створити акаунт

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

    Відкрийте агента в папці з вашим фото й вставте промпт вище. Агент завантажить SKILL.md, встановить навичку та запустить її CLI.

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

    Агент покаже короткий код. Відкрийте faceninja.net/device, увійшовши в акаунт, перевірте, що код збігається, і схваліть його. Далі агент працює сам.

Ключ копіювати не доводиться. Якщо ви все ж хочете використовувати ключ, створіть ключ API у вебзастосунку й задайте його як FACENINJA_API_KEY; навичка візьме його й пропустить код.

Промпти для справжніх завдань.

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

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 · Скрипт конвеєра з webhooks

Інтеграцію пише ваш агент; ви її перевіряєте й запускаєте.

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

Оболонка
curl -fsSL https://faceninja.net/skill/install.sh | sh

Windows (PowerShell)

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

ZIP

Завантажте навичку й розпакуйте її там, де ваш агент зберігає навички.

Отримати ZIP

Спершу прочитати

SKILL.md — звичайний текст. Прочитайте його або попросіть агента переказати, перш ніж щось запускати.

Файл 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. Що в голові

Вона питає, перш ніж витрачати.

  • Спершу вартість. Перед кожною головою навичка називає її вартість і те, що лишилося на балансі.
  • Партії чекають на «так». Якщо голів одразу понад 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 USD), як і у вебзастосунку та в API.
04Чи можна написати промпт своєю мовою?
Так, навколо URL. Залиште https://faceninja.net/skill/SKILL.md і шляхи до файлів точно як є, а решту агент виконає будь-якою зрозумілою йому мовою.
05Чи може агент побудувати цілий конвеєр?
Так. Промпт 4 вище просить написати його з webhooks і ключами ідемпотентності. Сторінки Розробникам і довідник API EN написано так, щоб їх міг прочитати й агент.
06Чи є сервер MCP?
Наразі немає. Навичка та llms.txt підходять для перелічених вище агентів. Напишіть нам, якщо ваш агент розуміє лише MCP.
07Чи бачить агент мої фото?
CLI навички завантажує їх прямо з вашого диска. Агент бачить назви файлів і результати. Якщо ви попросите його подивитися на фото, він подивиться через свого постачальника.
08Куди потрапляють файли?
Куди вкаже ваш промпт. Типовий промпт використовує ./faceninja-out.

Йдемо далі.

API

Webhooks, ключі ідемпотентності та партії — для конвеєра, що працює без агента.

Розробникам

Довідник

Кожна кінцева точка, поле й помилка, плюс файл OpenAPI 3.1.

Довідник API EN

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

Натомість завантажте фото в браузері.

До вебзастосунку

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

Створити акаунт