照片轉 MetaHuman · API 與 AI 代理
一個頭部，就是一次 API 呼叫。
用你的程式碼送出一個人的照片，或請你的 AI 代理代勞。大約 4 分鐘後，你會拿到完成的 MetaHuman 頭部：這個人自己的 4K 皮膚、毛髮（Groom）建議、貼合的頸部，以及 52 個 ARKit 混合變形（blendshape），共六種格式。每個頭部 1,500 點數，每點 US$0.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.貼到 Claude Code、Codex、Cursor、Gemini CLI 或 OpenClaw 裡。你只需核准一組代碼，不用複製金鑰。 請保留這段英文提示詞：你的 AI 代理需要原樣讀取其中的網址。之後你可以用中文和它交談。
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/faceninja立即回傳頭部的 id。完成時，我們會呼叫你的 webhook。
- 每點 US$0.01，用多少付多少
- 每個頭部 1,500 點數，所有檔案都包含
- 不需訂閱
- 失敗的頭部退還點數
- 1MetaHuman 拓樸每個頭部的頂點順序和 UV 都相同。
- 2眼睛與牙齒安放在各自的位置上；虹膜顏色取自照片。
- 34K 皮膚基礎色彩、法線、Cavity、鏡面與粗糙度。
- 452 個 ARKit 混合變形為這張臉量身製作，包含 tongueOut。
- 5貼合的頸部頸部與斜方肌依這個人的比例調整。
輸入：一張照片。輸出：這個頭部，未經修改。合成人物。
拖曳，或聚焦後按 ← →- 輸入
- 1 張照片同一個人最多 15 張
- 拓樸
- MetaHuman頭部、頸部、肩膀
- 表情
- 52 個 ARKit為這張臉量身製作
- 皮膚貼圖
- 4 × 4K基礎色彩、法線、Cavity、鏡面/粗糙
- 執行時間
- 約 4 分鐘每個頭部，不論哪種途徑
- 費率
- US$0.01每點 · 每個頭部 1,500 點
每次呼叫都會回傳完成的頭部，而不是光禿禿的網格。
只有在沒人需要手動收尾時，自動化才有意義。以下是每個頭部都包含的內容，不論來自 API、AI 代理或網頁應用程式，都不另外收費。
- MetaHuman 拓樸的臉。 頭部、頸部與肩膀、眼睛與牙齒。每個頭部的頂點順序和 UV 都相同，所以同一套 rig 適用於所有頭部。
- 這個人自己的皮膚。 4K 基礎色彩、法線、Cavity 與鏡面/粗糙度貼圖，採用 MetaHuman 的 UV 配置。
- 頭髮、眉毛、睫毛與鬍鬚，都有名稱。 附色彩數值的 MetaHuman Groom 建議，以
groom.json提供，你的工具可以直接讀取。 - 貼合的頸部。 頸部與斜方肌依這個人自己的比例調整。
- 52 個 ARKit 混合變形。 為這張臉量身製作，包含
tongueOut，可直接用於臉部追蹤和口型同步。 - 六種格式。 GLB、FBX、OBJ、STL、PLY 和 MetaHuman ZIP。想要哪一種都可以，要幾次都行。
四張困難的照片
強光、深皺紋
皮膚上的橘色色偏已去除；皺紋以凹凸起伏保留下來。
大笑與眼鏡
笑容不會被烘焙進形狀裡。
滿臉鬍鬚，頭部轉向
下顎線已還原；鬍鬚則以 Groom 的形式回來。
頭髮蓋住耳朵
臉是她的；耳朵形狀不取自照片。
這些人都不存在。照片是我們生成的，這樣測試時就不必用到任何人的臉。頭部就是實際輸出的結果。
查看範例。
這裡的每個頭部都是 FaceNinja 用一張照片做出來的，以輸出的原樣呈現。更多範例即將加入，包含更多種臉孔、光線和髮型。
在 API 做出的頭部上試試各種表情。
這是網頁應用程式為每個頭部顯示的同一個輕量預覽。每個按鈕都會驅動該頭部自己的 ARKit 混合變形。開啟頭髮預覽，就能連同頭髮一起判斷像不像。
範例頭部
方向鍵可轉動頭部，加號與減號縮放，按 0 重設視角，Esc 離開檢視器。
ARKit 讀數
數值會隨表情變化。拖曳滑桿可單獨設定一個混合變形。
一個頭部或五百個，都是同一個呼叫。
一個頭部大約需要 4 分鐘，所以 FaceNinja 從一開始就是非同步的。你送出請求，等我們通知，再去取檔案。讓批次作業能放心無人值守執行的一切，都在 API 裡，代理技能用的也是同一組 API。
你的代理就能做到。
- 建立帳號。 用 Google 或電子郵件建立帳號，再購買點數。
- 貼上一段提示詞 到 Claude Code、Codex、Cursor、Gemini CLI 或 OpenClaw 裡。
- 核准代碼 這組代碼由你的代理顯示在
faceninja.net/device。
接著再要求更多：「./cast 的每個子資料夾各做一個頭部」、「所有頭部再輸出一次 FBX」、「幫我寫一條 webhook 管線」。技能會在花費之前告訴你費用和你的餘額，超過 5 個頭部時會先詢問。
你的程式碼就能做到。
- 冪等金鑰。 用同一組金鑰重試建立請求，會拿到同一個頭部，絕不會扣第二次款。
- 簽章 webhook。
head.completed與head.failed，簽章放在FaceNinja-Signature。也可以用伺服器傳送事件串流，腳本則可用?wait。 - 容得下批次作業。 每個帳號每分鐘可建立 30 個頭部、送出 600 個請求。
- 可據以分支處理的錯誤。 穩定的錯誤碼，例如
no_face與not_same_person，每個都附有提示。 - 退款不必開客服單。 建立時先保留點數，頭部失敗時由系統自動釋放。
- 給連結，不給附件。 每個檔案都是一條短效的簽章連結。儲存頭部的 id，需要時再來要一次。
POST /v1/heads同一個人的照片- 頭部 id
head.completed完成時的簽章 webhookPOST /v1/heads/{id}/files格式- 短效簽章連結
Unreal 自動化會在 Unreal Engine 內貼合臉部、設定皮膚、套上 Groom 並挑選身體，目前為搶先體驗。來信詢問 搶先體驗
四種管線，同一種頭部。
一個頭部，在瀏覽器裡完成。
你不需要代理，也不需要 API 金鑰。用 Google 登入，放入同一個人的 1 到 15 張照片，大約 4 分鐘後就能下載頭部。下載前，網頁應用程式會顯示附有表情和頭髮的 3D 預覽。
自動化之前。
- 01我需要寫程式嗎？
- 不需要。把一段提示詞貼給 Claude Code 或 Cursor 這類 AI 代理，或在瀏覽器中使用網頁應用程式。搭配 AI 代理使用
- 02一個頭部要多久？
- 從上傳起大約 4 分鐘。等待的頭部很多時，你的會先排隊，API 會回報你在隊伍中的位置。
- 03需要幾張照片？
- 一張清晰的照片就夠了。同一個人最多 15 張照片會更有幫助，尤其是側面和四分之三角度。拍照技巧
- 04頭部失敗會怎樣？
- 它的 1,500 點數會自動退回你的餘額，
error.code會說明原因，例如no_face。 - 05頭髮算頭部的一部分嗎？
- 不算。在 MetaHuman 中，頭髮、眉毛和鬍鬚都是 Groom。我們會推薦合適的 Groom 與其顏色，以你的工具可以讀取的資料形式提供。
- 06我可以使用誰的照片？
- 你自己的照片，或是同意被製作 3D 頭部的成年人的照片。我們不會為兒童製作頭部，也不會用網路上找來的照片製作頭部。可接受使用政策 EN
- 07我的照片會怎麼處理？
- 照片會在 30 天後刪除，你也可以更早刪除頭部及其照片。隱私權政策 EN
你的第一個頭部，只差一段提示詞。
建立帳號、購買點數、貼上提示詞，然後核准代碼。