FaceNinja
繁體中文
建立帳號

指南 · Claude Code · Codex · Cursor · Gemini CLI · OpenClaw

用 Claude Code、Codex 或 Cursor 生成 3D 頭部。

你的 AI 程式設計代理可以替你生成 MetaHuman 頭部：用一張照片生成一個頭部，用一個資料夾生成一組角色，為你已有的每個頭部匯出 FBX，或者為你的管線寫一個指令碼。本指南介紹第一次執行、代理會問你什麼，以及它能做和不能做的事。

發布於

第一次執行，逐步說明

  1. 貼上一個提示詞

    在放有照片的資料夾中開啟代理，貼上下面這段。任何能執行 shell 命令或取得 URL 的代理都可以用；代理頁面為每個代理都準備了一個版本。

    提示詞 · 英文
    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 代理需要原樣讀取其中的網址。之後你可以用中文和它交談。

  2. 核准登入代碼

    代理會顯示一個簡短的代碼並開啟 faceninja.net/device。你在那裡登入並核准這組代碼。不需要把 API 金鑰貼到對話裡；技能把金鑰儲存在你的電腦上，並且從不顯示出來。

  3. 確認你有權使用這些照片

    生成第一個頭部之前，代理會給你看一段聲明，請你用自己的話確認：你有權使用這些照片，並已取得每個人的同意，他們都是成年人，而且你遵守內容與肖像政策 EN。代理從不替你確認。

  4. 代理先說明費用

    它會先檢查你的餘額，告訴你一個頭部的費用以及花費後還剩多少，然後才會花錢。超過五個頭部時，它會停下來請你確認總額。

  5. 先試試免費範例

    即使一個點數都沒有，代理也能下載 20 個範例頭部，讓你先測試管線的其餘部分。

  6. 先一個頭部，再一個資料夾

    生成一組角色時，把每個人的照片放進各自的子資料夾，然後貼上角色組提示詞。代理會清點頭部數量、說明總費用，並等你確認。

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

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

技能執行了什麼

這個技能是一個 Python 檔案，不需要安裝任何套件（Python 3.9 或更高版本）。由你的代理執行；你也可以自己執行。以下是它自帶的說明文字，未經編輯：

Shell
$ 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

代理能做什麼、不能做什麼

  • 用同一個人的 1–15 張照片生成頭部，每個子資料夾一個頭部，並下載 GLB、FBX、OBJ、STL、PLY 或 MetaHuman ZIP。
  • 檢視餘額、列出你的頭部並重新下載。
  • 依據 llms.txt 和技能，編寫帶冪等金鑰和 webhook 處理程序的管線指令碼。
  • 購買點數或開啟自動儲值：它會讓你去網頁應用程式操作。
  • 替你確認同意或核准登入。
  • 為兒童、公眾人物生成頭部，或使用網路上找來的照片。

關於用 AI 代理生成頭部的問題

01哪些代理可以用？
Claude Code、Codex、Cursor、Gemini CLI 和 OpenClaw，以及任何能執行 shell 命令或取得 URL 的代理。
02我需要把 API 金鑰貼到對話裡嗎？
不需要。你在瀏覽器裡核准一組代碼，技能會把金鑰儲存在你的電腦上。它從不顯示金鑰。
03代理會不經詢問就花錢嗎？
每項任務開始前，它都會告訴你費用和餘額；超過五個頭部時會停下來等你確認。
04有 MCP 伺服器嗎？
目前沒有。技能透過一個命令列指令碼工作，由代理直接執行。

用你自己的照片做一個 MetaHuman。

免費建立帳號，下載範例頭部，等付費方案開放後再用你自己的照片生成頭部。

建立帳號搭配 AI 代理使用