FaceNinja

Agent AI · Claude Code, Codex, Cursor, Gemini CLI, OpenClaw

Agent AI của bạn có thể tạo đầu 3D.

Dán một prompt vào Claude Code, Codex, Cursor, Gemini CLI hoặc OpenClaw. Agent của bạn đọc skill của chúng tôi, cài đặt nó, đăng nhập cho bạn bằng một mã mà bạn phê duyệt, rồi tạo đầu 3D MetaHuman từ ảnh của bạn. Không cần sao chép key. Khoảng 4 phút sau, tệp GLB và MetaHuman ZIP đã nằm trong thư mục của bạn.

Prompt mặc định
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.

Đổi ./photo.jpg thành đường dẫn tới ảnh của bạn. Giữ nguyên phần còn lại bằng tiếng Anh: agent cần URL đúng như đã viết.

  • 0,01 US$ một credit, trả theo mức dùng
  • 1.500 credit một đầu 3D, đã gồm mọi tệp
  • Skill hỏi trước khi tiêu credit
Ba khoảnh khắc của một lần chạy
  1. Agent của bạn in ra một mã như WXYZ-2345 và liên kết faceninja.net/device.

  2. Bạn mở /device khi đã đăng nhập, kiểm tra mã rồi nhấn Phê duyệt.

  3. Agent của bạn nêu chi phí và số dư của bạn, rồi lưu tệp GLB và MetaHuman ZIP.

Tài khoản, prompt, mã.

  1. Tạo tài khoản.

    Tạo tài khoản tại faceninja.net bằng Google hoặc e-mail, rồi mua số credit cho các đầu 3D bạn định tạo. Skill báo chi phí trước khi tiêu bất kỳ khoản nào.

    Tạo tài khoản

  2. Dán prompt.

    Mở agent của bạn trong thư mục chứa ảnh, rồi dán prompt ở trên. Agent tải SKILL.md, cài skill và chạy CLI của skill.

  3. Phê duyệt mã.

    Agent hiển thị cho bạn một mã ngắn. Mở faceninja.net/device khi đã đăng nhập, kiểm tra mã có khớp không, rồi phê duyệt. Agent tự tiếp tục.

Bạn không bao giờ phải sao chép key. Nếu muốn dùng key, hãy tạo một API key trong ứng dụng web và đặt nó thành FACENINJA_API_KEY; skill sẽ dùng key đó và bỏ qua bước nhập mã.

Prompt cho việc thật.

Mỗi prompt đều nêu URL của skill, nên chạy được trong một phiên mới chưa cài gì. Hãy đổi đường dẫn thành của bạn. Các prompt giữ nguyên bằng tiếng Anh ở mọi phiên bản ngôn ngữ của trang này, vì agent phải đọc đúng URL và tên tệp. Sau đó bạn vẫn có thể nói chuyện với agent bằng ngôn ngữ của mình.

01 · Một đầu 3D từ một ảnh Mặc định

Đầu 3D đầu tiên của bạn, hoặc một lần thử nhanh.

Prompt · Tiếng Anh
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.

02 · Dàn nhân vật từ một thư mục

Mỗi người một thư mục con, mỗi thư mục có từ 1 đến 15 ảnh.

Prompt · Tiếng Anh
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>.

Một dàn nhân vật có hơn 5 đầu 3D luôn dừng lại chờ bạn đồng ý. Skill được xây theo cách đó; prompt chỉ nói rõ điều này ra. 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.

03 · FBX cho đầu 3D bạn đã tạo

Tải lại ở định dạng khác. Không có gì được tạo mới hay bị tính phí.

Prompt · Tiếng Anh
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.

Tệp vẫn tải được trong 30 ngày sau khi đầu 3D hoàn tất. 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.

04 · Script pipeline webhook

Agent của bạn viết phần tích hợp; bạn xem lại rồi chạy.

Prompt · Tiếng Anh
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.

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.

05 · Kiểm tra số dư

Trước một việc lớn, hoặc khi một lần chạy đã dừng.

Prompt · Tiếng Anh
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.

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.

Dán vào đâu.

Cùng một prompt dùng được trong tất cả các agent này. Chỉ khác nơi bạn dán nó.

Mở terminal trong thư mục dự án, chạy claude, rồi dán prompt.

Prompt · Tiếng Anh
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.

Hoặc cài skill cho agent này trước, rồi yêu cầu:

Prompt · Tiếng Anh
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.

Cài vào ~/.claude/skills/faceninja (hoặc $CLAUDE_CONFIG_DIR/skills). Các phiên mới tự nạp skill.

Claude Code, Codex, Cursor, Gemini CLI và OpenClaw là nhãn hiệu của chủ sở hữu tương ứng. FaceNinja không liên kết với họ.

Hoặc cài skill trước.

Nhờ agent đọc SKILL.md là cách nhanh nhất. Nếu bạn muốn tự cài skill, hoặc agent của bạn không tải được URL, hãy dùng một trong các cách sau.

macOS và Linux

Shell
curl -fsSL https://faceninja.net/skill/install.sh | sh

Windows (PowerShell)

PowerShell
irm https://faceninja.net/skill/install.ps1 | iex

ZIP

Tải skill về và giải nén vào nơi agent của bạn lưu skill.

Tải ZIP

Đọc trước đã

SKILL.md là văn bản thuần. Hãy đọc nó, hoặc nhờ agent tóm tắt, trước khi chạy bất cứ thứ gì.

Mở SKILL.md

Hãy đọc một script trước khi chuyển nó vào shell. Cả hai trình cài đặt đều ngắn; mở install.sh EN hoặc install.ps1 EN để xem chúng làm gì.

Bạn cần: Python 3 cho CLI, vốn chỉ là một tệp, không có phụ thuộc, và một kết nối internet. Không cài thêm gì khác.

Cho agent chỉ đọc web: https://faceninja.net/llms.txt liệt kê tài liệu, tệp OpenAPI và skill theo dạng mà mô hình ngôn ngữ đọc tốt.

Agent của bạn có thể yêu cầu gì.

Skill là một lớp mỏng phủ lên FaceNinja API. Agent của bạn làm được những gì API làm được, với các bước kiểm tra bên dưới được tích hợp sẵn.

Đăng nhập cho bạn

Bằng một mã bạn phê duyệt tại faceninja.net/device, hoặc bằng FACENINJA_API_KEY.

Tạo đầu 3D

Từ 1 đến 15 ảnh của mỗi người, một đầu 3D hoặc cả một thư mục nhiều người.

Chờ kết quả

Một đầu 3D mất khoảng 4 phút. Skill chờ đến khi xong hoặc khi lỗi.

Tải mọi định dạng

GLB, FBX, OBJ, STL, PLY hoặc MetaHuman ZIP, có hoặc không có 52 blendshape ARKit.

Lấy lại đầu 3D cũ

Tải một định dạng khác của đầu 3D bạn đã tạo, khi tệp của nó còn được giữ (30 ngày).

Hiển thị số dư

Số credit còn lại và số đầu 3D mà chúng chi trả được.

Mọi đầu 3D do skill tạo đều là một đầu 3D FaceNinja đầy đủ: map da 4K, đề xuất groom (tóc MetaHuman), phần cổ khớp và 52 blendshape ARKit. Đầu 3D gồm gì

Skill hỏi trước khi tiêu credit.

  • Chi phí trước. Trước mỗi đầu 3D, skill cho bạn biết chi phí và số dư còn lại.
  • Cả lô phải chờ bạn đồng ý. Hơn 5 đầu 3D cùng lúc, skill sẽ dừng lại và hỏi.
  • Đầu 3D lỗi được hoàn lại. Nếu một đầu 3D bị lỗi, 1.500 credit của nó tự quay lại số dư của bạn, và lỗi cho biết lý do.
  • Không có key trong cuộc trò chuyện. Đăng nhập bằng mã cấp cho skill quyền truy cập mà không có key nào xuất hiện trong prompt hay lịch sử của bạn. Bạn tự phê duyệt từng lần đăng nhập mới.
  • Bạn chọn mức trần. Skill chỉ tiêu được số credit bạn đã mua. Không có gói đăng ký và không có gì để hủy.
  • Ảnh bị xóa sau 30 ngày. CLI tải ảnh từ ổ đĩa của bạn lên FaceNinja. Việc agent của bạn có xem chúng hay không tùy vào agent và prompt của bạn.
  • Chỉ những khuôn mặt đã đồng ý. Dùng ảnh của chính bạn hoặc của người trưởng thành đã đồng ý. Không dùng ảnh trẻ em, không dùng ảnh từ internet. Quy tắc sử dụng EN

Câu hỏi về agent.

01Tôi có cần API key không?
Không. Agent hiển thị một mã cho bạn, và bạn phê duyệt nó tại faceninja.net/device. Nếu môi trường của bạn không thể hiển thị mã, ví dụ một tác vụ trên máy chủ, hãy tạo một API key trong ứng dụng web và đặt FACENINJA_API_KEY.
02Skill chạy được với những agent nào?
Claude Code, Codex, Cursor, Gemini CLI và OpenClaw, cùng mọi agent chạy được lệnh shell hoặc tải được một URL.
03Skill tốn bao nhiêu?
Không tốn gì. Một đầu 3D tốn 1.500 credit (15 US$), giống như trong ứng dụng web và API.
04Tôi có thể viết prompt bằng ngôn ngữ của mình không?
Được, ở xung quanh các URL. Giữ nguyên https://faceninja.net/skill/SKILL.md và các đường dẫn tệp của bạn, agent sẽ làm theo phần còn lại bằng bất kỳ ngôn ngữ nào nó hiểu.
05Agent của tôi có thể dựng cả một pipeline không?
Có. Prompt 4 ở trên yêu cầu nó viết một pipeline với webhook và idempotency key. Trang Developer và tài liệu tham chiếu API EN cũng được viết để agent đọc được.
06Có máy chủ MCP không?
Hiện chưa có. Skill và llms.txt bao phủ các agent kể trên. Nhắn cho chúng tôi nếu agent của bạn chỉ nói được MCP.
07Agent có nhìn thấy ảnh của tôi không?
CLI của skill tải ảnh thẳng từ ổ đĩa của bạn. Agent của bạn thấy tên tệp và kết quả. Nếu bạn nhờ nó xem một ảnh, nó sẽ xem, thông qua nhà cung cấp riêng của nó.
08Các tệp được lưu ở đâu?
Ở nơi prompt của bạn chỉ định. Prompt mặc định dùng ./faceninja-out.

Đi xa hơn.

API

Webhook, idempotency key và xử lý theo lô, cho khi pipeline chạy mà không cần agent.

Developer

Tài liệu tham chiếu

Mọi endpoint, trường và lỗi, cùng một tệp OpenAPI 3.1.

Tài liệu API EN

Một đầu 3D, không cần code

Thay vào đó, hãy tải một ảnh lên ngay trong trình duyệt.

Mở ứng dụng web

Một prompt. Một đầu 3D hoàn chỉnh.

Tạo tài khoản