Từ ảnh sang MetaHuman · API và agent AI
Một đầu 3D là một lệnh gọi API.
Gửi ảnh của một người từ code của bạn, hoặc nhờ agent AI làm việc đó. Khoảng 4 phút sau, bạn nhận được một đầu 3D MetaHuman hoàn chỉnh: làn da riêng của người đó ở độ phân giải 4K, đề xuất groom (tóc MetaHuman), phần cổ khớp và 52 blendshape ARKit, trong sáu định dạng. Mỗi đầu 3D là 1.500 credit với giá 0,01 US$ một credit, và một đầu 3D bị lỗi không tốn gì.
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.Dán vào Claude Code, Codex, Cursor, Gemini CLI hoặc OpenClaw. Bạn phê duyệt một mã; không cần sao chép key nào. 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.
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/faceninjaTrả về id của đầu 3D ngay lập tức. Khi xong, chúng tôi gọi webhook của bạn.
- 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
- Không có gói đăng ký
- Đầu 3D lỗi được hoàn lại




- 1Topology MetaHumanCùng thứ tự vertex và UV trên mọi đầu 3D.
- 2Mắt và răngNằm đúng trong hốc; màu mống mắt lấy từ ảnh.
- 3Da 4KBase color, normal, cavity, specular/roughness.
- 452 blendshape ARKitTạo riêng cho khuôn mặt này, có cả tongueOut.
- 5Phần cổ vừa khớpCổ và cơ thang theo đúng người đó.
Vào: một ảnh. Ra: đầu 3D này, chưa chỉnh sửa. Một người tổng hợp.
Kéo, hoặc chọn rồi dùng ← →- Đầu vào
- 1 ảnhtối đa 15 ảnh của một người
- Topology
- MetaHumanđầu, cổ, vai
- Biểu cảm
- 52 ARKittạo riêng cho khuôn mặt
- Map da
- 4 × 4Kcolor, normal, cavity, spec/rough
- Thời gian
- khoảng 4 phútmỗi đầu 3D, cách nào cũng vậy
- Đơn giá
- 0,01 US$mỗi credit · 1.500 một đầu 3D
Mỗi lệnh gọi trả về một đầu 3D hoàn chỉnh, không phải một mesh trọc.
Tự động hóa chỉ đáng làm nếu không ai phải hoàn thiện kết quả bằng tay. Đây là những gì mỗi đầu 3D có, dù đến từ API, agent hay ứng dụng web, không tính thêm phí.
- Khuôn mặt, theo topology MetaHuman. Đầu, cổ và vai, mắt và răng. Cùng thứ tự vertex và UV trên mọi đầu 3D, nên một rig dùng được cho tất cả.
- Làn da riêng của người đó. Các map base color, normal, cavity và specular/roughness 4K, theo bố cục UV của MetaHuman.
- Tóc, lông mày, lông mi và râu, có tên cụ thể. Đề xuất groom MetaHuman kèm giá trị màu, trong
groom.jsonmà công cụ của bạn đọc được. - Phần cổ vừa khớp. Cổ và cơ thang theo đúng tỷ lệ cơ thể riêng của người đó.
- 52 blendshape ARKit. Tạo riêng cho khuôn mặt này, có cả
tongueOut, dùng được ngay cho face tracking và lip sync. - Sáu định dạng. GLB, FBX, OBJ, STL, PLY và MetaHuman ZIP. Cần định dạng nào cũng được, bao nhiêu lần cũng được.
Bốn ảnh khó
Sáng gắt, nếp nhăn sâu


Màu ám cam đã biến mất khỏi da; nếp nhăn vẫn còn, dưới dạng độ nổi khối.
Cười và đeo kính


Nụ cười không bị gắn cứng vào hình dạng đầu.
Râu rậm, quay đầu


Phần hàm được khôi phục; bộ râu trở lại dưới dạng groom.
Tóc che tai


Khuôn mặt là của cô ấy; hình dạng tai không lấy từ ảnh.
Những người này đều không có thật. Chúng tôi tạo các ảnh này để thử nghiệm mà không cần dùng khuôn mặt của ai. Các đầu 3D được giữ nguyên như kết quả đầu ra.
Xem các mẫu.
Mỗi đầu 3D ở đây do FaceNinja tạo từ một ảnh và được hiển thị đúng như kết quả đầu ra. Sắp có thêm mẫu, với nhiều kiểu khuôn mặt, ánh sáng và mái tóc hơn.












Thử các biểu cảm trên một đầu 3D do API tạo ra.
Đây là cùng bản xem trước nhẹ mà ứng dụng web hiển thị cho mọi đầu 3D. Mỗi nút điều khiển các blendshape ARKit của chính đầu 3D đó. Bật xem trước tóc để đánh giá độ giống khi có tóc.
Đầu 3D mẫu

Phím mũi tên xoay đầu. Phím cộng và trừ để thu phóng. Phím 0 đặt lại góc nhìn. Phím Escape thoát trình xem.
Số liệu ARKit
Các giá trị theo biểu cảm. Kéo một thanh trượt để đặt một shape.
Một đầu 3D hay năm trăm, vẫn là cùng một lệnh gọi.
Một đầu 3D mất khoảng 4 phút, nên FaceNinja chạy bất đồng bộ ngay từ đầu. Bạn gửi, bạn nhận phản hồi, bạn tải về. Mọi thứ giúp chạy một lô đầu 3D an toàn mà không cần ai trông đều nằm trong API, và skill của agent dùng chính API đó.
Agent của bạn làm được.
- Tạo tài khoản. Tạo tài khoản bằng Google hoặc e-mail, rồi mua credit.
- Dán một prompt vào Claude Code, Codex, Cursor, Gemini CLI hoặc OpenClaw.
- Phê duyệt mã mà agent hiển thị cho bạn tại
faceninja.net/device.
Sau đó cứ yêu cầu thêm: “mỗi thư mục con của ./cast một đầu 3D”, “tất cả đầu 3D xuất lại dạng FBX”, “viết cho tôi một pipeline webhook”. Skill báo chi phí và số dư của bạn trước khi tiêu credit, và hỏi lại trước khi tạo hơn 5 đầu 3D.
Code của bạn làm được.
- Idempotency key. Gửi lại một lệnh tạo với cùng key, bạn nhận đúng đầu 3D cũ, không bị tính phí lần thứ hai.
- Webhook có chữ ký.
head.completedvàhead.failed, ký trongFaceNinja-Signature. Hoặc một luồng server-sent event, hoặc?waitcho script. - Đủ chỗ cho cả lô. 30 lượt tạo đầu 3D và 600 request mỗi phút cho mỗi tài khoản.
- Lỗi bạn có thể rẽ nhánh theo. Mã ổn định như
no_facevànot_same_person, mỗi mã kèm một gợi ý. - Hoàn lại, không cần ticket. Credit được giữ lại khi tạo và tự động trả về nếu đầu 3D bị lỗi.
- Liên kết, không phải tệp đính kèm. Mỗi tệp đến dưới dạng một liên kết có chữ ký, hết hạn nhanh. Hãy lưu id của đầu 3D, cần thì hỏi lại.
POST /v1/headsảnh của một người- id đầu 3D
head.completedwebhook có chữ ký khi xongPOST /v1/heads/{id}/filesđịnh dạng- liên kết có chữ ký, hết hạn nhanh
Tự động hóa Unreal, giúp conform khuôn mặt, đặt da, gắn groom và chọn thân hình ngay trong Unreal Engine, đang ở giai đoạn truy cập sớm. Hãy hỏi chúng tôi Truy cập sớm
Bốn kiểu pipeline, một kiểu đầu 3D.
Công cụ và nền tảng
Thêm “tạo đầu 3D từ ảnh” vào sản phẩm của bạn. Webhook đi vào, liên kết có chữ ký đi ra, hoàn lại không cần ticket hỗ trợ.
DeveloperStudio game
Khuôn mặt người chơi hoặc một dàn NPC, tất cả trên cùng một mesh, nên một rig và một material dùng được cho mọi đầu 3D.
Đầu 3D cho gameNgười làm việc với agent
Giao việc cho Claude Code, Codex hoặc Cursor: một dàn nhân vật từ một thư mục, FBX cho mọi đầu 3D, một script pipeline.
Dùng với agent AI0,01 US$ một credit, dù bạn yêu cầu theo cách nào.
API, agent của bạn và ứng dụng web cùng dùng một số dư với một mức giá. Mua credit theo gói hoặc theo số lượng tùy ý, không cần đăng ký. Một đầu 3D là 1.500 credit, và nếu bị lỗi, credit của nó tự quay lại. Thuế bán hàng hoặc VAT được cộng khi thanh toán, nếu áp dụng.
Một đầu 3D, ngay trong trình duyệt.
Bạn không cần agent hay API key. Đăng nhập bằng Google, thả vào từ một đến 15 ảnh của một người, rồi tải đầu 3D về sau khoảng 4 phút. Ứng dụng web hiển thị bản xem trước 3D với biểu cảm và tóc trước khi bạn tải về.
Trước khi bạn tự động hóa.
- 01Tôi có cần viết code không?
- Không. Dán một prompt vào agent AI như Claude Code hoặc Cursor, hoặc dùng ứng dụng web ngay trong trình duyệt. Dùng với agent AI
- 02Một đầu 3D mất bao lâu?
- Khoảng 4 phút kể từ lúc tải lên. Khi có nhiều đầu 3D đang chờ, đầu 3D của bạn sẽ xếp hàng, và API báo vị trí của nó trong hàng.
- 03Tôi cần bao nhiêu ảnh?
- Một ảnh nét là đủ. Tối đa 15 ảnh của cùng một người sẽ giúp ích, nhất là ảnh nghiêng và ảnh chếch ba phần tư. Mẹo chụp ảnh
- 04Điều gì xảy ra 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à
error.codecho biết lý do, ví dụno_face. - 05Tóc có nằm trong đầu 3D không?
- Không. Trong MetaHuman, tóc, lông mày và râu là groom. Chúng tôi đề xuất groom phù hợp cùng màu của chúng, dưới dạng dữ liệu mà công cụ của bạn đọc được.
- 06Tôi được dùng ảnh của ai?
- Ảnh của chính bạn, hoặc ảnh của một người trưởng thành đã đồng ý cho tạo đầu 3D từ ảnh của họ. Chúng tôi không tạo đầu 3D của trẻ em hay từ ảnh tìm thấy trên mạng. Quy tắc sử dụng EN
- 07Ảnh của tôi sẽ ra sao?
- Ảnh được xóa sau 30 ngày, và bạn có thể xóa một đầu 3D cùng ảnh của nó sớm hơn. Chính sách quyền riêng tư EN
Đầu 3D đầu tiên của bạn chỉ cách một prompt.
Tạo tài khoản, mua credit, dán prompt rồi phê duyệt mã.