FaceNinja

AI 에이전트 · Claude Code, Codex, Cursor, Gemini CLI, OpenClaw

AI 에이전트가 헤드를 만들 수 있습니다.

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을 쓰인 그대로 받아야 합니다.

  • 크레딧당 US$0.01, 쓴 만큼 결제
  • 헤드당 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로 설정하십시오. 스킬이 그 키를 쓰고 코드 단계를 건너뜁니다.

실제 작업용 프롬프트.

각 프롬프트에 스킬의 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

셸
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

필요한 것: CLI용 Python 3(의존성 없는 파일 하나)과 인터넷 연결. 그 밖에는 아무것도 설치되지 않습니다.

웹만 읽는 에이전트용: https://faceninja.net/llms.txt에 문서, OpenAPI 파일, 스킬이 언어 모델이 읽기 좋은 형태로 정리되어 있습니다.

에이전트에게 요청할 수 있는 것.

스킬은 FaceNinja API 위의 얇은 층입니다. 에이전트는 API가 하는 일을 모두 할 수 있고, 아래 확인 절차가 기본으로 들어 있습니다.

로그인

faceninja.net/device에서 직접 승인하는 코드나 FACENINJA_API_KEY로.

헤드 만들기

한 사람당 사진 1~15장으로, 헤드 하나 또는 여러 사람이 든 폴더 전체.

완료 대기

헤드 하나에 약 4분이 걸립니다. 스킬은 완료되거나 실패할 때까지 기다립니다.

어떤 포맷이든 다운로드

GLB, FBX, OBJ, STL, PLY 또는 MetaHuman ZIP. ARKit 블렌드셰이프 52개 포함 여부를 고를 수 있습니다.

이전 헤드 가져오기

파일이 보관되는 동안(30일) 이미 만든 헤드를 다른 포맷으로 다운로드합니다.

잔액 표시

남은 크레딧과 그 크레딧으로 만들 수 있는 헤드 수.

스킬이 만드는 헤드는 모두 완전한 FaceNinja 헤드입니다. 4K 피부 맵, 그룸 추천, 인물에 맞춘 목, ARKit 블렌드셰이프 52개. 헤드 구성

크레딧을 쓰기 전에 묻습니다.

  • 비용부터. 헤드를 만들기 전에 스킬이 비용과 남은 잔액을 알려 줍니다.
  • 배치는 확인을 기다립니다. 한 번에 헤드가 5개를 넘으면 스킬이 멈추고 묻습니다.
  • 실패한 헤드는 환불됩니다. 헤드가 실패하면 1,500 크레딧이 저절로 잔액으로 돌아오고, 오류가 이유를 알려 줍니다.
  • 채팅에 키가 남지 않습니다. 코드 로그인은 프롬프트나 기록에 키가 한 번도 나타나지 않게 스킬에 접근 권한을 줍니다. 새 로그인은 매번 직접 승인합니다.
  • 상한은 직접 정합니다. 스킬은 구매한 크레딧만 쓸 수 있습니다. 구독도 없고 해지할 것도 없습니다.
  • 사진은 30일 후 삭제됩니다. CLI가 디스크에서 FaceNinja로 사진을 업로드합니다. 에이전트도 사진을 들여다볼지는 에이전트와 프롬프트에 달려 있습니다.
  • 동의한 얼굴만. 본인 사진이나 동의한 성인의 사진을 쓰십시오. 아동 사진과 인터넷에서 가져온 사진은 안 됩니다. 허용 사용 정책 EN

에이전트에 관한 질문.

01API 키가 필요합니까?
아닙니다. 에이전트가 코드를 보여 주면 faceninja.net/device에서 승인합니다. 서버 작업처럼 코드를 보여 줄 수 없는 환경이라면 웹 앱에서 API 키를 만들어 FACENINJA_API_KEY로 설정하십시오.
02어떤 에이전트에서 작동합니까?
Claude Code, Codex, Cursor, Gemini CLI, OpenClaw, 그리고 셸 명령을 실행하거나 URL을 가져올 수 있는 모든 에이전트입니다.
03스킬은 얼마입니까?
무료입니다. 헤드는 웹 앱이나 API와 같이 개당 1,500 크레딧(US$15)입니다.
04프롬프트를 한국어로 써도 됩니까?
네, URL 외의 부분은 됩니다. https://faceninja.net/skill/SKILL.md와 파일 경로만 그대로 두면, 에이전트는 나머지를 자신이 이해하는 어떤 언어로든 따릅니다.
05에이전트가 파이프라인 전체를 만들 수 있습니까?
네. 위의 프롬프트 4는 webhook과 멱등성 키를 쓰는 파이프라인을 작성하게 합니다. 에이전트도 읽을 수 있게 작성한 문서: 개발자 페이지, API 레퍼런스 EN.
06MCP 서버가 있습니까?
아직 없습니다. 위에 나온 에이전트는 스킬과 llms.txt로 충분합니다. 에이전트가 MCP만 지원한다면 문의해 주십시오.
07에이전트가 제 사진을 봅니까?
스킬의 CLI가 디스크에서 바로 업로드합니다. 에이전트는 파일 이름과 결과를 봅니다. 사진을 봐 달라고 요청하면 에이전트는 자체 제공업체를 통해 사진을 봅니다.
08파일은 어디에 저장됩니까?
프롬프트에서 지정한 곳입니다. 기본 프롬프트는 ./faceninja-out을 씁니다.

더 나아가기.

API

webhook, 멱등성 키, 배치. 에이전트 없이 파이프라인을 돌릴 때.

개발자

레퍼런스

모든 엔드포인트, 필드, 오류와 OpenAPI 3.1 파일.

API 레퍼런스 EN

코드 없이 헤드 하나

대신 브라우저에서 사진을 업로드하십시오.

웹 앱 열기

프롬프트 하나. 완성된 헤드 하나.

계정 만들기