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. 创建账号。

    在 faceninja.net 用 Google 或邮箱创建账号,并为你计划生成的头部购买积分。技能会在花费任何积分之前告诉你费用。

    创建账号

  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.

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

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 个头部的一组角色,一定会停下来等你确认。技能本来就是这样设计的;提示词只是把它写明白。 请保留这段英文提示词:你的智能体需要原样读取其中的网址。之后你可以用中文和它交流。

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 天可供下载。 请保留这段英文提示词:你的智能体需要原样读取其中的网址。之后你可以用中文和它交流。

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.

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

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.

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

粘贴到哪里。

这些智能体里用的是同一个提示词,只是粘贴的位置不同。

在项目文件夹里打开终端,运行 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.

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

或者先为这个智能体安装技能,再提出要求:

提示词 · 英文
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 混合变形。

取回之前的头部

在文件仍保留期间(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

一个头部,无需代码

改为在浏览器里上传一张照片。

打开网页应用

一个提示词,一个成品头部。

创建账号