Від фото до MetaHuman · API і ШІ-агенти
Голова — це виклик API.
Надішліть фото людини зі свого коду або попросіть про це ШІ-агента. Приблизно через 4 хвилини ви отримаєте готову голову MetaHuman: власна шкіра людини в 4K, рекомендації щодо groom (волосся MetaHuman), підігнана шия та 52 форми ARKit, у шести форматах. 1 500 кредитів за голову по 0,01 USD за кредит, а невдала голова нічого не коштує.
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 USD за кредит, оплата за використання
- 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 USDза кредит · 1 500 на голову
Кожен виклик повертає готову голову, а не лисий меш.
Автоматизація має сенс, лише якщо результат не доводиться допрацьовувати вручну. Ось що містить кожна голова — з API, від агента чи з вебзастосунку, без доплат.
- Обличчя в топології MetaHuman. Голова, шия й плечі, очі та зуби. Однаковий порядок вершин і UV на кожній голові, тож один риг підходить усім.
- Власна шкіра людини. Карти 4K: базовий колір, нормалі, cavity і specular/roughness, у UV-розкладці MetaHuman.
- Волосся, брови, вії й борода — з назвами. Рекомендації grooms MetaHuman зі значеннями кольору у вигляді
groom.json, який читають ваші інструменти. - Шия, що пасує. Шия й трапеції відповідають пропорціям самої людини.
- 52 форми ARKit. Зроблені для цього обличчя, зокрема
tongueOut; готові до трекінгу обличчя та синхронізації губ. - Шість форматів. GLB, FBX, OBJ, STL, PLY і MetaHuman ZIP. Запитуйте будь-який, скільки завгодно разів.
Чотири складні фото
Різке світло, зморшки


Помаранчевий відтінок зі шкіри зник; зморшки лишилися рельєфом.
Сміх і окуляри


Сміх не запікається у форму.
Борода, голова повернута


Щелепу відновлено; борода повертається як groom.
Волосся закриває вуха


Обличчя її; форму вух із фото не беруть.
Цих людей не існує. Ми згенерували фото, щоб тестувати, не використовуючи чиєсь обличчя. Голови — саме такі, які вийшли.
Перегляньте зразки.
Кожну голову тут FaceNinja зробив з одного фото, і показано її так, як вона вийшла. Скоро з'являться нові зразки з більшим розмаїттям облич, світла й волосся.












Спробуйте вирази на голові, яку зробив API.
Це той самий легкий перегляд, який вебзастосунок показує для кожної голови. Кожна кнопка керує власними формами ARKit голови. Увімкніть перегляд із волоссям, щоб оцінити подібність із волоссям.
Зразки голів

Стрілки повертають голову. Плюс і мінус масштабують. Нуль скидає вигляд. Escape виходить із переглядача.
Показники ARKit
Значення йдуть за виразом. Повзунок задає одну форму.
Одна голова чи п'ятсот — той самий виклик.
Голова робиться приблизно 4 хвилини, тому FaceNinja від початку асинхронний. Ви надсилаєте, чекаєте відповіді, забираєте результат. Усе, що дозволяє безпечно запускати партію без нагляду, є в API, а навичка для агентів працює через той самий API.
Це може зробити ваш агент.
- Створіть акаунт. Зареєструйтеся через Google або електронну пошту й купіть кредити.
- Вставте один промпт у Claude Code, Codex, Cursor, Gemini CLI або OpenClaw.
- Схваліть код, який агент покаже вам на
faceninja.net/device.
Потім просіть більше: «по голові на кожну підпапку ./cast», «усі голови ще раз у FBX», «напиши мені конвеєр на webhook». Навичка називає вартість і ваш баланс, перш ніж щось витратити, і питає дозволу, якщо голів більше 5.
Це може зробити ваш код.
- Ключі ідемпотентності. Повторіть створення з тим самим ключем — отримаєте ту саму голову й жодного другого списання.
- Підписані webhooks.
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, яка підганяє обличчя, ставить шкіру, одягає grooms і вибирає тіло просто в Unreal Engine, перебуває на етапі раннього доступу. Запитати доступ Ранній доступ
Чотири види конвеєрів, один вид голови.
Інструменти й платформи
Додайте у свій продукт «зробити голову з фото». Webhooks на вході, підписані посилання на виході, повернення без звернень у підтримку.
РозробникамІгрові студії
Обличчя гравців або акторський склад NPC, усе на одному меші, тож один риг і один матеріал підходять кожній голові.
Голови для гриТі, хто працює з агентами
Доручіть роботу Claude Code, Codex або Cursor: акторський склад із папки, FBX для кожної голови, скрипт конвеєра.
Для ШІ-агентівТехнічні художники
Відкрийте MetaHuman Creator, де підгонка, шкіра й grooms уже визначені.
Що в голові0,01 USD за кредит, незалежно від способу замовлення.
API, ваш агент і вебзастосунок беруть кредити з одного балансу за однією ціною. Купуйте кредити пакетом або на будь-яку суму, без підписки. Голова коштує 1 500 кредитів, а якщо вона не вдалася, кредити повертаються самі. Податок з продажів або ПДВ додається під час оплати, де це застосовно.
Одна голова — у браузері.
Агент чи ключ API не потрібні. Увійдіть через Google, додайте від 1 до 15 фото однієї людини й завантажте голову приблизно за 4 хвилини. Вебзастосунок показує 3D-перегляд із виразами та волоссям ще до завантаження.
Перш ніж автоматизувати.
- 01Чи потрібно писати код?
- Ні. Вставте один промпт у ШІ-агента, наприклад Claude Code чи Cursor, або користуйтеся вебзастосунком у браузері. Для ШІ-агентів
- 02Скільки часу триває створення голови?
- Приблизно 4 хвилини від завантаження. Коли чекає багато голів, ваша стає в чергу, а API повідомляє її місце в черзі.
- 03Скільки фото потрібно?
- Достатньо одного чіткого фото. Допомагає до 15 фото тієї самої людини, особливо профіль і ракурс три чверті. Поради до фото
- 04Що буде, якщо голова не вдасться?
- Її 1 500 кредитів повертаються на ваш баланс самі, а
error.codeпояснює причину, наприкладno_face. - 05Чи волосся входить у голову?
- Ні. У MetaHuman волосся, брови й борода — це grooms. Ми рекомендуємо відповідні з їхніми кольорами, як дані, що їх читають ваші інструменти.
- 06Чиї фото можна використовувати?
- Власні або фото дорослої людини, яка погодилася на створення своєї 3D-голови. Ми не робимо голів дітей і не працюємо з фото, знайденими в інтернеті. Допустиме використання EN
- 07Що відбувається з моїми фото?
- Їх видаляють через 30 днів, а голову та її фото ви можете видалити й раніше. Політика конфіденційності EN
До вашої першої голови — один промпт.
Створіть акаунт, купіть кредити, вставте промпт і схваліть код.