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.

    请保留这段英文提示词：你的智能体需要原样读取其中的网址。之后你可以用中文和它交流。

  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>.

    请保留这段英文提示词：你的智能体需要原样读取其中的网址。之后你可以用中文和它交流。

技能运行了什么

这个技能是一个 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 智能体使用