照片到 MetaHuman · API 与 AI 智能体
一个头部，就是一次 API 调用。
从你的代码里发送一个人的照片，或者让你的 AI 智能体来发。约 4 分钟后，你会得到一个成品 MetaHuman 头部：这个人自己的 4K 皮肤、毛发（Groom）推荐、贴合的脖子和 52 个 ARKit 混合变形，共六种格式。每个头部 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 里。你批准一个代码即可，不用复制密钥。 请保留这段英文提示词：你的智能体需要原样读取其中的网址。之后你可以用中文和它交流。
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、智能体还是网页应用，都不额外收费。
- MetaHuman 拓扑的人脸。 头部、脖子和肩膀，眼睛和牙齿。每个头部的顶点顺序和 UV 都相同，所以一套绑定适用于所有头部。
- 这个人自己的皮肤。 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