Из фото в MetaHuman · API и ИИ-агенты
Голова — это вызов API.
Отправьте фото человека из своего кода или попросите об этом ИИ-агента. Примерно через 4 минуты вы получите готовую голову MetaHuman: собственная кожа человека в 4K, рекомендации по groom (волосам MetaHuman), подогнанная шея и 52 формы ARKit в шести форматах. 1 500 кредитов за голову по 0,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.Вставьте в Claude Code, Codex, Cursor, Gemini CLI или OpenClaw. Вы подтверждаете код; копировать ключ не нужно. Оставьте этот промпт на английском: агенту нужен веб-адрес точно в таком виде. Потом можно общаться с ним на своём языке.
curl https://api.faceninja.net/v1/heads \
-H "Authorization: Bearer $FACENINJA_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-F photos=@photo.jpg -F webhook_url=https://you.example/hooks/faceninjaСразу возвращает id головы. Когда она готова, мы вызываем ваш webhook.
- 0,01 $ за кредит, оплата по мере использования
- 1 500 кредитов за голову, все файлы включены
- Без подписки
- За неудачные головы кредиты возвращаются




- 1Топология MetaHumanОдинаковый порядок вершин и UV у каждой головы.
- 2Глаза и зубыНа своих местах; цвет радужки берётся с фото.
- 3Кожа в 4KБазовый цвет, нормали, cavity, specular/roughness.
- 452 формы ARKitСозданы под это лицо, включая tongueOut.
- 5Шея, которая подходитШея и трапеции подстраиваются под человека.
Вход: одно фото. Выход: эта голова, без правок. Синтетический человек.
Тяните или ← → с клавиатуры- Вход
- 1 фотодо 15 фото одного человека
- Топология
- MetaHumanголова, шея, плечи
- Мимика
- 52 ARKitсозданы под лицо
- Карты кожи
- 4 × 4Kцвет, нормали, cavity, spec/rough
- Время
- около 4 минутна голову, любым способом
- Тариф
- 0,01 $за кредит · 1 500 на голову
Каждый вызов возвращает готовую голову, а не лысый меш.
Автоматизация имеет смысл, только если результат не нужно дорабатывать вручную. Вот что входит в каждую голову — из API, от агента или из веб-приложения — без доплат.
- Лицо в топологии MetaHuman. Голова, шея и плечи, глаза и зубы. Одинаковый порядок вершин и UV у каждой головы, поэтому один риг подходит всем.
- Собственная кожа человека. Карты базового цвета, нормалей, cavity и specular/roughness в 4K, в UV-раскладке MetaHuman.
- Волосы, брови, ресницы и борода — с названиями. Рекомендации по groom MetaHuman со значениями цвета в файле
groom.json, который читают ваши инструменты. - Шея, которая подходит. Шея и трапеции повторяют пропорции самого человека.
- 52 формы ARKit. Созданы под это лицо, включая
tongueOut, и готовы для трекинга лица и липсинка. - Шесть форматов. GLB, FBX, OBJ, STL, PLY и MetaHuman ZIP. Запрашивайте любой, сколько угодно раз.
Четыре сложных фото
Жёсткий свет, морщины


Оранжевый оттенок с кожи ушёл; морщины остались как рельеф.
Смех и очки


Смех не запечён в форму.
Борода, голова повёрнута


Челюсть восстановлена; борода возвращается как groom.
Волосы закрывают уши


Лицо её; форма ушей по фото не берётся.
Этих людей не существует. Мы сгенерировали фото, чтобы тестировать без чьего-либо лица. Головы — ровно то, что получилось.
Смотрите примеры.
Каждую голову здесь FaceNinja сделал по одному фото, и она показана ровно такой, какой получилась. Скоро появятся новые примеры: больше типов лиц, света и волос.












Попробуйте выражения на голове, созданной через API.
Это тот же лёгкий предпросмотр, что веб-приложение показывает для каждой головы. Каждая кнопка управляет собственными формами ARKit этой головы. Включите предпросмотр волос, чтобы оценить сходство уже с волосами.
Примеры голов

Стрелки поворачивают голову. Плюс и минус — масштаб. Ноль сбрасывает вид. Escape выходит из просмотрщика.
Значения ARKit
Значения следуют выражению. Ползунок задаёт одну форму.
Одна голова или пятьсот — один и тот же вызов.
Голова делается около 4 минут, поэтому FaceNinja асинхронен с самого начала. Вы отправляете, вам отвечают, вы забираете. Всё, что делает пакетный запуск безопасным без присмотра, есть в API, а навык для агентов использует тот же API.
Это может сделать ваш агент.
- Создайте аккаунт. Создайте аккаунт через Google или по e-mail и купите кредиты.
- Вставьте один промпт в Claude Code, Codex, Cursor, Gemini CLI или OpenClaw.
- Подтвердите код, который агент покажет вам на
faceninja.net/device.
Дальше просите больше: «по одной голове на каждую подпапку ./cast», «все головы ещё раз в FBX», «напишите мне пайплайн с webhook». Навык называет стоимость и ваш баланс до списания и спрашивает, если голов больше 5.
Это может сделать ваш код.
- Ключи идемпотентности. Повторите создание с тем же ключом, и вы получите ту же голову без второго списания.
- Подписанные webhook.
head.completedиhead.failed, подпись вFaceNinja-Signature. Или поток server-sent events, или?waitдля скриптов. - Запас для пакетной обработки. 30 созданий голов и 600 запросов в минуту на аккаунт.
- Ошибки, по которым можно ветвить логику. Стабильные коды, например
no_faceиnot_same_person, каждый с подсказкой. - Возвраты без тикетов. Кредиты резервируются при создании и сами освобождаются, если голова не удалась.
- Ссылки, а не вложения. Каждый файл приходит короткоживущей подписанной ссылкой. Сохраните id головы и запрашивайте снова, когда понадобится.
POST /v1/headsфото одного человека- id головы
head.completedподписанный webhook, когда готовоPOST /v1/heads/{id}/filesформат- короткоживущая подписанная ссылка
Автоматизация в Unreal, которая подгоняет лицо, ставит кожу, надевает groom и подбирает тело внутри Unreal Engine, находится в раннем доступе. Запросить доступ Ранний доступ
Четыре вида пайплайнов, один вид головы.
Инструменты и платформы
Добавьте в свой продукт функцию «сделать голову по фото». Webhook на входе, подписанные ссылки на выходе, возвраты без обращений в поддержку.
РазработчикамИгровые студии
Лица игроков или группа NPC на одном меше: один риг и один материал подходят каждой голове.
Головы для игрыТе, кто работает с агентами
Передайте задачу Claude Code, Codex или Cursor: группу людей из папки, FBX для каждой головы, скрипт пайплайна.
Для ИИ-агентовТехнические художники
Откройте MetaHuman Creator с уже готовыми подгонкой лица, кожей и groom.
Что в 3D-голове0,01 $ за кредит, каким бы способом вы ни заказывали.
API, ваш агент и веб-приложение списывают с одного баланса по одной цене. Покупайте кредиты пакетом или на любую сумму, без подписки. Голова стоит 1 500 кредитов, а если она не удалась, её кредиты возвращаются сами. Налог с продаж или НДС добавляется при оплате там, где он применяется.
Одна голова, прямо в браузере.
Агент и ключ API не нужны. Войдите через Google, загрузите от одного до 15 фото одного человека и скачайте голову примерно через 4 минуты. Веб-приложение показывает 3D-предпросмотр с выражениями и волосами до скачивания.
Прежде чем автоматизировать.
- 01Нужно ли писать код?
- Нет. Вставьте один промпт в ИИ-агента, например Claude Code или Cursor, или пользуйтесь веб-приложением в браузере. Для ИИ-агентов
- 02Сколько делается одна голова?
- Примерно 4 минуты с момента загрузки. Когда в очереди много голов, ваша ждёт своей очереди, а API сообщает её место.
- 03Сколько нужно фото?
- Достаточно одного чёткого фото. До 15 фото одного человека помогают, особенно профиль и ракурс в три четверти. Советы по фото
- 04Что будет, если голова не удалась?
- Её 1 500 кредитов сами возвращаются на ваш баланс, а
error.codeназывает причину, напримерno_face. - 05Волосы входят в голову?
- Нет. В MetaHuman волосы, брови и бороды — это groom. Мы рекомендуем подходящие, с их цветами, в виде данных, которые читают ваши инструменты.
- 06Чьи фото можно использовать?
- Свои или фото взрослого, который согласился на создание своей 3D-головы. Мы не делаем головы детей и не используем фото, найденные в интернете. Допустимое использование EN
- 07Что происходит с моими фото?
- Они удаляются через 30 дней, а голову и её фото можно удалить и раньше. Политика конфиденциальности EN
Ваша первая голова — на расстоянии одного промпта.
Создайте аккаунт, купите кредиты, вставьте промпт и подтвердите код.