FaceNinja

AI 代理 · Claude Code、Codex、Cursor、Gemini CLI、OpenClaw

你的 AI 代理就能做出頭部。

把一段提示詞貼進 Claude Code、Codex、Cursor、Gemini CLI 或 OpenClaw。你的代理會讀取我們的技能、安裝它、用你核准的代碼幫你登入,並用你的照片做出 MetaHuman 頭部。不用複製金鑰。大約 4 分鐘後,GLB 與 MetaHuman ZIP 就會出現在你的資料夾裡。

預設提示詞
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.

把 ./photo.jpg 改成你的照片路徑。其餘部分保持英文:代理需要原樣讀取網址。

  • 每點 US$0.01,用多少付多少
  • 每個頭部 1,500 點數,所有檔案都包含
  • 技能在花費前會先詢問
一次執行的三個時刻
  1. 你的代理會印出一組代碼,例如 WXYZ-2345,以及連結 faceninja.net/device。

  2. 你在已登入的狀態下開啟 /device,核對代碼,然後按下 核准。

  3. 你的代理會說明費用與你的餘額,然後儲存 GLB 與 MetaHuman ZIP。

帳號、提示詞、代碼。

  1. 建立帳號。

    用 Google 或電子郵件在 faceninja.net 建立帳號,再為你計畫製作的頭部購買點數。技能在花費任何點數之前,都會先告訴你費用。

    建立帳號

  2. 貼上提示詞。

    在存放你照片的資料夾中開啟你的代理,貼上上面的提示詞。代理會抓取 SKILL.md、安裝技能並執行它的 CLI。

  3. 核准代碼。

    代理會顯示一組簡短的代碼。在已登入的狀態下開啟 faceninja.net/device,確認代碼相符後核准。代理會自己繼續執行。

你不必複製金鑰。如果你想用金鑰,可以在網頁應用程式中建立 API 金鑰,並設為 FACENINJA_API_KEY;技能會使用它,並略過代碼登入。

給實際工作用的提示詞。

每段提示詞都寫明技能的網址,所以在沒有安裝任何東西的全新工作階段中也能運作。請把路徑改成你自己的。本站每個語言版本的提示詞都維持英文,因為代理必須原樣讀取網址和檔名。之後你仍然可以用自己的語言和代理交談。

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.

請保留這段英文提示詞:你的 AI 代理需要原樣讀取其中的網址。之後你可以用中文和它交談。

02 · 用資料夾做一整組角色

每個人一個子資料夾,每個資料夾放 1 到 15 張照片。

提示詞 · 英文
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>.

超過 5 個頭部的一整組角色,一律會停下來等你同意。技能本來就是這樣設計的;提示詞只是把這點寫明。 請保留這段英文提示詞:你的 AI 代理需要原樣讀取其中的網址。之後你可以用中文和它交談。

03 · 為已做好的頭部輸出 FBX

改用其他格式重新下載。不會製作新的頭部,也不會收費。

提示詞 · 英文
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.

頭部完成後,檔案會保留 30 天。 請保留這段英文提示詞:你的 AI 代理需要原樣讀取其中的網址。之後你可以用中文和它交談。

04 · webhook 管線腳本

你的代理撰寫整合程式;你檢查後再執行。

提示詞 · 英文
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.

請保留這段英文提示詞:你的 AI 代理需要原樣讀取其中的網址。之後你可以用中文和它交談。

05 · 查詢餘額

在大型工作之前,或是某次執行中斷時。

提示詞 · 英文
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.

請保留這段英文提示詞:你的 AI 代理需要原樣讀取其中的網址。之後你可以用中文和它交談。

貼在哪裡。

同一段提示詞在以下每一個代理都能用,差別只在貼上的地方。

在專案資料夾開啟終端機,執行 claude,然後貼上提示詞。

提示詞 · 英文
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.

請保留這段英文提示詞:你的 AI 代理需要原樣讀取其中的網址。之後你可以用中文和它交談。

或者先為這個代理安裝技能,再提出要求:

提示詞 · 英文
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.

安裝到 ~/.claude/skills/faceninja(或 $CLAUDE_CONFIG_DIR/skills)。新的工作階段會自動載入。

Claude Code、Codex、Cursor、Gemini CLI 與 OpenClaw 是各自所有者的商標。FaceNinja 與它們沒有隸屬關係。

或者先安裝技能。

請代理讀取 SKILL.md 是最快的方式。如果你想自己安裝技能,或你的代理無法抓取網址,請用以下其中一種。

macOS 與 Linux

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

Windows(PowerShell)

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

ZIP

下載技能,並解壓縮到你的代理存放技能的位置。

下載 ZIP

先讀過再說

SKILL.md 是純文字。在執行任何東西之前,先讀一遍,或請你的代理幫你摘要。

開啟 SKILL.md

把腳本用管線交給 shell 執行之前,請先讀過它。兩個安裝程式都很短,想看它們做了什麼,請開啟 install.sh EN 或 install.ps1 EN。

你需要: CLI 需要 Python 3(它是單一檔案,沒有任何相依套件),以及網路連線。不會安裝其他任何東西。

給只讀網頁的代理: https://faceninja.net/llms.txt 以語言模型容易讀取的形式,列出文件、OpenAPI 檔案和技能。

你的代理可以要求什麼。

技能是 FaceNinja API 之上薄薄的一層。你的代理能做 API 能做的事,並內建以下檢查。

幫你登入

用你在 faceninja.net/device 核准的代碼,或用 FACENINJA_API_KEY。

建立頭部

每個人提供 1 到 15 張照片,可做單一頭部,也可做整個資料夾的人物。

等待完成

一個頭部大約需要 4 分鐘。技能會等到頭部完成或失敗為止。

下載任何格式

GLB、FBX、OBJ、STL、PLY 或 MetaHuman ZIP,可選擇是否包含 52 個 ARKit 混合變形(blendshape)。

取回之前的頭部

在檔案還保留的期間(30 天),可以下載你已做好的頭部的另一種格式。

顯示你的餘額

剩餘的點數,以及這些點數夠做幾個頭部。

技能做出的每個頭部都是完整的 FaceNinja 頭部:4K 皮膚貼圖、毛髮(Groom)建議、貼合的頸部和 52 個 ARKit 混合變形。頭部內容

花費之前,它會先問。

  • 先講費用。 在做任何頭部之前,技能都會告訴你費用,以及你的餘額還剩多少。
  • 批次要等你同意。 一次超過 5 個頭部,技能就會停下來詢問。
  • 失敗的頭部會退還點數。 如果頭部失敗,它的 1,500 點數會自動退回你的餘額,錯誤訊息也會說明原因。
  • 聊天裡沒有金鑰。 用代碼登入,技能就能取得存取權,金鑰不會出現在你的提示詞或歷史紀錄裡。每一次新的登入,都由你自己核准。
  • 上限由你決定。 技能只能花用你買的點數。沒有訂閱,也沒有需要取消的東西。
  • 照片會在 30 天後刪除。 CLI 會把照片從你的磁碟上傳到 FaceNinja。你的代理是否也會查看這些照片,取決於代理和你的提示詞。
  • 只用同意過的臉。 請使用你自己的照片,或已同意的成年人的照片。不用兒童的照片,也不用網路上的照片。可接受使用政策 EN

關於代理的問題。

01我需要 API 金鑰嗎?
不需要。代理會顯示一組代碼,你在 faceninja.net/device 核准即可。如果你的環境無法顯示代碼,例如伺服器上的工作,請在網頁應用程式中建立 API 金鑰,並設定 FACENINJA_API_KEY。
02它能搭配哪些代理?
Claude Code、Codex、Cursor、Gemini CLI 和 OpenClaw,以及任何能執行 shell 指令或抓取網址的代理。
03這個技能要花多少錢?
不用錢。一個頭部需要 1,500 點數(US$15),和網頁應用程式與 API 相同。
04我可以用自己的語言寫提示詞嗎?
可以,網址以外的部分都行。請把 https://faceninja.net/skill/SKILL.md 和你的檔案路徑維持原樣,其餘的部分,代理能理解哪種語言就能照做。
05我的代理可以建立整條管線嗎?
可以。上面的提示詞 4 就是請它用 webhook 和冪等金鑰寫一條。代理也能讀懂 開發者 頁面和 API 參考文件 EN。
06有 MCP 伺服器嗎?
目前沒有。技能和 llms.txt 已涵蓋上面列出的代理。如果你的代理只支援 MCP,請寫信給我們。
07代理看得到我的照片嗎?
技能的 CLI 會直接從你的磁碟上傳照片。你的代理只會看到檔名和結果。如果你請它查看某張照片,它就會看,並透過它自己的服務供應商處理。
08檔案會存到哪裡?
提示詞指定哪裡就存到哪裡。預設的提示詞使用 ./faceninja-out。

更進一步。

API

當管線不經過代理執行時,需要用到 webhook、冪等金鑰和批次作業。

開發者

參考文件

每個端點、欄位和錯誤,另附 OpenAPI 3.1 檔案。

API 參考文件 EN

一個頭部,不寫程式

改在瀏覽器中上傳照片。

開啟網頁應用程式

一段提示詞,一個完成的頭部。

建立帳號