사진에서 MetaHuman으로 · API와 AI 에이전트
헤드는 API 호출 한 번입니다.
코드에서 인물 사진을 보내거나 AI 에이전트에게 맡기면 됩니다. 약 4분 뒤 완성된 MetaHuman 헤드를 받습니다. 4K로 담은 본인의 피부, 그룸 추천, 인물에 맞춘 목, ARKit 블렌드셰이프 52개가 6개 포맷으로 들어 있습니다. 헤드당 1,500 크레딧(크레딧당 US$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을 호출합니다.
- 크레딧당 US$0.01, 쓴 만큼 결제
- 헤드당 1,500 크레딧, 모든 파일 포함
- 구독 없음
- 실패한 헤드는 환불




- 1MetaHuman 토폴로지모든 헤드의 버텍스 순서와 UV가 같습니다.
- 2눈과 치아안구는 제자리에, 홍채 색은 사진에서 가져옵니다.
- 34K 피부베이스 컬러, 노멀, 캐비티, 스페큘러/러프니스.
- 4ARKit 블렌드셰이프 52개이 얼굴에 맞게 만들었고, tongueOut도 포함됩니다.
- 5인물에 맞는 목목과 승모근이 인물을 따릅니다.
입력: 사진 한 장. 출력: 손대지 않은 이 헤드. 합성 인물입니다.
드래그하거나 포커스 후 ← → 키- 입력
- 사진 1장한 사람의 사진 최대 15장
- 토폴로지
- MetaHuman머리, 목, 어깨
- 표정
- ARKit 52개이 얼굴에 맞게 제작
- 피부 맵
- 4 × 4K컬러, 노멀, 캐비티, 스펙/러프
- 소요 시간
- 약 4분헤드당, 어떤 경로든
- 요금
- US$0.01크레딧당 · 헤드당 1,500
모든 호출은 민머리 메시가 아니라 완성된 헤드를 반환합니다.
결과물을 아무도 손으로 마무리하지 않아도 될 때 자동화할 가치가 있습니다. API, 에이전트, 웹 앱 어디서 만들든 모든 헤드에는 추가 요금 없이 다음이 들어 있습니다.
- MetaHuman 토폴로지의 얼굴. 머리, 목과 어깨, 눈과 치아. 모든 헤드의 버텍스 순서와 UV가 같아서 리그 하나가 모든 헤드에 맞습니다.
- 본인의 피부. MetaHuman UV 레이아웃의 4K 베이스 컬러, 노멀, 캐비티, 스페큘러/러프니스 맵.
- 머리카락, 눈썹, 속눈썹, 수염의 이름까지. 컬러 값이 포함된 MetaHuman 그룸 추천을 툴에서 읽을 수 있는
groom.json으로 제공합니다. - 인물에 맞는 목. 목과 승모근이 인물 본인의 비율을 따릅니다.
- ARKit 블렌드셰이프 52개. 이 얼굴에 맞게 만들었고
tongueOut도 포함됩니다. 페이스 트래킹과 립싱크에 바로 쓸 수 있습니다. - 6개 포맷. GLB, FBX, OBJ, STL, PLY, MetaHuman ZIP. 어떤 포맷이든 원하는 만큼 요청할 수 있습니다.
어려운 사진 4장
강한 조명, 깊은 주름


피부의 주황빛은 사라지고, 주름은 요철로 남았습니다.
웃음과 안경


웃는 표정은 형태에 남지 않습니다.
풍성한 수염, 돌린 고개


턱선을 복원하고, 수염은 그룸으로 돌아옵니다.
귀를 덮은 머리카락


얼굴은 본인의 것이고, 귀 모양은 사진에서 가져오지 않습니다.
이 사람들은 모두 실존하지 않습니다. 누구의 얼굴도 쓰지 않고 테스트하려고 사진을 생성했습니다. 헤드는 나온 그대로입니다.
샘플을 보십시오.
여기 있는 헤드는 모두 FaceNinja가 사진 한 장으로 만든 것이며, 나온 그대로 보여 드립니다. 얼굴, 조명, 머리 모양이 더 다양한 샘플이 계속 추가됩니다.












API가 만든 헤드로 표정을 바꿔 보십시오.
웹 앱이 모든 헤드에 보여 주는 것과 같은 가벼운 미리보기입니다. 버튼마다 헤드 자체의 ARKit 블렌드셰이프를 움직입니다. 헤어 미리보기를 켜면 머리카락까지 포함해 닮았는지 판단할 수 있습니다.
샘플 헤드

화살표 키로 헤드를 돌립니다. +와 -로 확대·축소합니다. 0은 시점을 초기화합니다. Esc는 뷰어를 닫습니다.
ARKit 값
값은 표정을 따라갑니다. 슬라이더로 셰이프 하나를 설정합니다.
헤드 하나든 오백 개든, 호출은 같습니다.
헤드 하나에 약 4분이 걸리므로 FaceNinja는 처음부터 비동기로 설계했습니다. 보내고, 알림을 받고, 가져옵니다. 배치를 무인으로 안전하게 돌리는 데 필요한 것은 모두 API에 있고, 에이전트 스킬도 같은 API를 씁니다.
에이전트가 할 수 있습니다.
- 계정 만들기. Google이나 이메일로 계정을 만들고 크레딧을 구매하십시오.
- 프롬프트 붙여 넣기. Claude Code, Codex, Cursor, Gemini CLI 또는 OpenClaw에 프롬프트 하나를 붙여 넣습니다.
- 코드 승인. 에이전트가 보여 주는 코드를
faceninja.net/device에서 승인합니다.
그다음에는 더 요청하면 됩니다. “./cast의 하위 폴더마다 헤드 하나씩”, “모든 헤드를 FBX로 다시”, “webhook 파이프라인을 작성해 줘”. 스킬은 크레딧을 쓰기 전에 비용과 잔액을 알려 주고, 헤드가 5개를 넘으면 먼저 묻습니다.
코드가 할 수 있습니다.
- 멱등성 키. 같은 키로 생성을 재시도하면 같은 헤드를 받고, 두 번 청구되지 않습니다.
- 서명된 webhook.
head.completed와head.failed,FaceNinja-Signature로 서명됩니다. 서버 전송 이벤트(SSE) 스트림이나 스크립트용?wait도 쓸 수 있습니다. - 배치를 위한 여유. 계정당 분당 헤드 생성 30건, 요청 600건.
- 분기할 수 있는 오류.
no_face,not_same_person처럼 고정된 코드와 각각의 힌트. - 티켓 없는 환불. 크레딧은 생성 시 보류되고, 헤드가 실패하면 저절로 해제됩니다.
- 첨부 파일이 아닌 링크. 파일마다 수명이 짧은 서명된 링크로 받습니다. 헤드 id를 저장해 두고 필요할 때 다시 요청하십시오.
POST /v1/heads한 사람의 사진- 헤드 id
head.completed완료 시 서명된 webhookPOST /v1/heads/{id}/files포맷- 수명이 짧은 서명된 링크
Unreal Engine 안에서 얼굴을 컨폼하고, 피부를 설정하고, 그룸을 입히고, 바디를 고르는 Unreal 자동화는 얼리 액세스입니다. 요청하기 얼리 액세스
파이프라인은 넷, 헤드는 하나.
헤드 하나는 브라우저에서.
에이전트도 API 키도 필요 없습니다. Google로 로그인하고 한 사람의 사진을 1~15장 올리면, 약 4분 뒤 헤드를 다운로드할 수 있습니다. 웹 앱은 다운로드 전에 표정과 머리카락이 들어간 3D 미리보기를 보여 줍니다.
자동화하기 전에.
- 01코드를 작성해야 합니까?
- 아닙니다. Claude Code나 Cursor 같은 AI 에이전트에 프롬프트 하나를 붙여 넣거나, 브라우저에서 웹 앱을 쓰면 됩니다. AI 에이전트에서 사용
- 02헤드 하나에 얼마나 걸립니까?
- 업로드부터 약 4분입니다. 대기 중인 헤드가 많으면 대기열에 들어가고, API가 대기 순번을 알려 줍니다.
- 03사진이 몇 장 필요합니까?
- 선명한 사진 한 장이면 충분합니다. 같은 사람의 사진을 최대 15장까지 더하면 도움이 되며, 특히 측면과 3/4 각도 사진이 좋습니다. 사진 팁
- 04헤드가 실패하면 어떻게 됩니까?
- 1,500 크레딧이 저절로 잔액으로 돌아오고,
error.code가 이유를 알려 줍니다. 예:no_face. - 05머리카락도 헤드에 포함됩니까?
- 아닙니다. MetaHuman에서 머리카락, 눈썹, 수염은 그룸입니다. 맞는 그룸을 색과 함께, 툴이 읽을 수 있는 데이터로 추천해 드립니다.
- 06누구의 사진을 써도 됩니까?
- 본인 사진, 또는 자신의 3D 헤드 제작에 동의한 성인의 사진입니다. 아동의 헤드는 만들지 않으며, 인터넷에서 찾은 사진으로도 만들지 않습니다. 허용 사용 정책 EN
- 07제 사진은 어떻게 됩니까?
- 30일 후 삭제되며, 그 전에 헤드와 사진을 직접 삭제할 수도 있습니다. 개인정보처리방침 EN
첫 헤드까지 프롬프트 하나면 됩니다.
계정을 만들고 크레딧을 산 뒤, 프롬프트를 붙여 넣고 코드를 승인하십시오.