Claude Code, Codex, Cursor로 3D 헤드 만들기.

첫 실행, 단계별 안내

1. 프롬프트 붙여 넣기

   사진이 있는 폴더에서 에이전트를 열고 이 프롬프트를 붙여 넣으십시오. 셸 명령을 실행하거나 URL을 가져올 수 있는 에이전트라면 어디서든 작동합니다. 에이전트별 버전은 에이전트 페이지에 있습니다.

   프롬프트 · 영어프롬프트 복사

   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.

   이 프롬프트는 영어 그대로 사용하십시오. 에이전트가 웹 주소를 쓰인 그대로 읽어야 합니다. 그다음부터는 한국어로 대화하셔도 됩니다.

2. 로그인 코드 승인

   에이전트가 짧은 코드를 보여 주고 faceninja.net/device를 엽니다. 거기서 로그인하고 코드를 승인하십시오. 채팅에 API 키를 붙여 넣지 않습니다. 스킬은 키를 내 컴퓨터에 보관하며 절대 출력하지 않습니다.

3. 사진을 써도 되는지 확인

   첫 헤드 전에 에이전트가 확인 문구를 보여 주면, 직접 자신의 말로 확인하십시오. 사진을 쓸 권리와 각 인물의 동의가 있다는 것, 모두 성인이라는 것, 그리고 다음 정책을 따른다는 내용입니다: 콘텐츠와 초상 정책 EN. 에이전트가 대신 확인하는 일은 없습니다.

4. 에이전트가 먼저 비용을 알려 줍니다

   크레딧을 쓰기 전에 잔액을 확인하고, 헤드 하나의 비용과 남는 잔액을 알려 줍니다. 헤드가 다섯 개를 넘으면 멈추고 합계를 확인해 달라고 요청합니다.

5. 무료 샘플 써 보기

   크레딧이 전혀 없어도 에이전트는 샘플 헤드 20개를 다운로드할 수 있으므로, 파이프라인의 나머지 부분을 먼저 시험해 볼 수 있습니다.

6. 헤드 하나, 그다음 폴더

   캐스트를 만들려면 인물마다 하위 폴더에 사진을 넣고 캐스트 프롬프트를 붙여 넣으십시오. 에이전트가 헤드 수를 세고 합계를 알려 준 뒤 승인을 기다립니다.

   프롬프트 · 영어프롬프트 복사

   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>.

   이 프롬프트는 영어 그대로 사용하십시오. 에이전트가 웹 주소를 쓰인 그대로 읽어야 합니다. 그다음부터는 한국어로 대화하셔도 됩니다.

스킬이 실행하는 것

스킬은 설치할 패키지가 없는 Python 파일 하나입니다(Python 3.9 이상). 에이전트가 실행하며, 직접 실행할 수도 있습니다. 아래는 손대지 않은 스킬 자체의 도움말입니다.

$ python3 faceninja.py --help
usage: faceninja.py [-h] [--json] [--base BASE] [--version] COMMAND ...

FaceNinja: photos in, MetaHuman head out.

positional arguments:
  COMMAND
    login      sign in by approving a code in the browser
    whoami     who is signed in
    balance    credits left and what a head costs
    make       make one head from 1-15 photos of one person
    status     where a head stands
    download   download a finished head's files
    batch      one head per photo, or per subfolder with --per-person-
               subfolders
    samples    the free sample heads: list them, or --download ID|all (no
               credits)
    list       your heads, newest first
    logout     revoke and forget the saved key
    update     update the skill now (it also updates itself at most hourly)
    guidance   the server's current rules and notices for agents
    attest     the user confirms, once per computer, that they may use the
               photos (asked before the first head)

options:
  -h, --help   show this help message and exit
  --json       one JSON object on stdout, progress on stderr
  --base BASE  API server (default $FACENINJA_API_BASE or
               https://faceninja.net)
  --version    show program's version number and exit

에이전트가 할 수 있는 일과 할 수 없는 일

• 한 사람의 사진 1~15장으로 하위 폴더마다 헤드 하나를 만들고, GLB, FBX, OBJ, STL, PLY 또는 MetaHuman ZIP을 다운로드합니다.
• 잔액을 확인하고, 헤드 목록을 보고, 다시 다운로드합니다.
• llms.txt와 스킬을 바탕으로, 멱등성 키와 webhook 핸들러를 갖춘 파이프라인 스크립트를 작성합니다.

• 크레딧 구매나 자동 충전 설정. 대신 웹 앱으로 안내합니다.
• 사용자 대신 동의를 확인하거나 로그인을 승인하는 일.
• 아동이나 공인의 헤드, 또는 인터넷에서 찾은 사진으로 헤드를 만드는 일.

AI 에이전트로 만드는 헤드에 관한 질문

01어떤 에이전트에서 됩니까?

Claude Code, Codex, Cursor, Gemini CLI, OpenClaw, 그리고 셸 명령을 실행하거나 URL을 가져올 수 있는 모든 에이전트입니다.

02채팅에 API 키를 붙여 넣어야 합니까?

아니요. 브라우저에서 코드를 승인하면 스킬이 키를 내 컴퓨터에 보관합니다. 키는 절대 출력하지 않습니다.

03에이전트가 묻지 않고 크레딧을 쓸 수 있습니까?

작업마다 먼저 비용과 잔액을 알려 주고, 헤드가 다섯 개를 넘으면 멈추고 확인을 기다립니다.

04MCP 서버가 있습니까?

지금은 없습니다. 스킬은 에이전트가 직접 실행하는 명령줄 스크립트로 작동합니다.