Tạo đầu 3D từ Claude Code, Codex hoặc Cursor.

Lần chạy đầu tiên, từng bước

1. Dán một prompt

   Mở agent trong thư mục có ảnh của bạn và dán đoạn này. Nó chạy trong mọi agent có thể chạy lệnh shell hoặc tải một URL; trang agent có phiên bản cho từng agent.

   Prompt · Tiếng AnhChép prompt

   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.

   Hãy giữ nguyên prompt này bằng tiếng Anh: agent của bạn cần địa chỉ web đúng như đã viết. Sau đó bạn có thể trò chuyện với nó bằng ngôn ngữ của mình.

2. Duyệt mã đăng nhập

   Agent hiển thị cho bạn một mã ngắn và mở faceninja.net/device. Bạn đăng nhập ở đó và duyệt mã. Không có API key nào được dán vào cuộc trò chuyện; skill giữ key trên máy tính của bạn và không bao giờ in nó ra.

3. Xác nhận bạn có quyền dùng các ảnh

   Trước đầu 3D đầu tiên, agent cho bạn xem một tuyên bố để xác nhận bằng lời của chính bạn: bạn có quyền dùng các ảnh và có sự đồng ý của từng người, họ là người trưởng thành, và bạn tuân theo Chính sách nội dung và hình ảnh cá nhân EN. Agent không bao giờ xác nhận thay bạn.

4. Agent báo chi phí trước

   Nó kiểm tra số dư và cho bạn biết một đầu 3D tốn bao nhiêu và còn lại bao nhiêu trước khi chi bất cứ thứ gì. Với hơn năm đầu 3D, nó dừng lại và yêu cầu bạn xác nhận tổng số.

5. Thử các mẫu miễn phí

   Dù không có credit nào, agent vẫn tải được 20 đầu 3D mẫu, để bạn thử phần còn lại của pipeline trước.

6. Một đầu 3D, rồi cả thư mục

   Với một dàn nhân vật, đặt ảnh của mỗi người vào thư mục con riêng và dán prompt cho dàn nhân vật. Agent đếm số đầu 3D, báo tổng và chờ bạn đồng ý.

   Prompt · Tiếng AnhChép prompt

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

   Hãy giữ nguyên prompt này bằng tiếng Anh: agent của bạn cần địa chỉ web đúng như đã viết. Sau đó bạn có thể trò chuyện với nó bằng ngôn ngữ của mình.

Skill chạy gì

Skill là một tệp Python duy nhất, không cần cài package nào (Python 3.9 trở lên). Agent của bạn chạy nó; bạn cũng có thể tự chạy. Đây là phần trợ giúp của chính nó, chưa chỉnh sửa:

$ 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

Agent làm được gì và không làm được gì

• Tạo đầu 3D từ 1–15 ảnh của một người, mỗi thư mục con một đầu 3D, và tải về GLB, FBX, OBJ, STL, PLY hoặc MetaHuman ZIP.
• Kiểm tra số dư, liệt kê các đầu 3D của bạn và tải lại chúng.
• Viết script pipeline với idempotency key và trình xử lý webhook, dựa trên llms.txt và skill.

• Mua credit hay bật tự động nạp: thay vào đó, nó chuyển bạn sang ứng dụng web.
• Xác nhận sự đồng ý hay duyệt đăng nhập thay cho bạn.
• Tạo đầu 3D của trẻ em, của người nổi tiếng, hay từ ảnh tìm thấy trên mạng.

Câu hỏi về đầu 3D từ agent AI

01Agent nào dùng được?

Claude Code, Codex, Cursor, Gemini CLI và OpenClaw, cùng mọi agent có thể chạy lệnh shell hoặc tải một URL.

02Tôi có phải dán API key vào cuộc trò chuyện không?

Không. Bạn duyệt một mã trong trình duyệt, và skill giữ key trên máy tính của bạn. Nó không bao giờ in key ra.

03Agent có thể chi tiền mà không hỏi không?

Nó báo chi phí và số dư của bạn trước mỗi công việc, và dừng lại chờ bạn xác nhận khi vượt quá năm đầu 3D.

04Có MCP server không?

Hiện chưa có. Skill hoạt động qua một script dòng lệnh mà agent chạy trực tiếp.