Claude Code、Codex、Cursorから3Dヘッドを作る。

初回の流れ、ステップごとに

1. プロンプトを1つ貼る

   写真のあるフォルダでエージェントを開き、これを貼り付けます。シェルコマンドを実行できるか、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.

   このプロンプトは英語のまま使ってください。エージェントは書かれたとおりのURLを読む必要があります。その後のやり取りは日本語でかまいません。

2. ログインコードを承認する

   エージェントが短いコードを表示し、faceninja.net/deviceを開きます。そこでログインしてコードを承認します。チャットにAPIキーを貼ることはありません。スキルはキーをあなたのコンピューターに保管し、表示することはありません。

3. 写真を使ってよいことを確認する

   最初のヘッドの前に、エージェントが確認文を表示します。あなた自身の言葉で確認してください。内容は、写真を使う権利と各人物の同意があること、全員が成人であること、そして次のポリシーに従うことです：コンテンツと肖像に関するポリシー EN。エージェントが代わりに確認することはありません。

4. エージェントが先に費用を伝える

   何かを使う前に残高を確認し、ヘッド1つの費用と残りの残高を伝えます。5ヘッドを超える場合は止まり、合計の確認を求めます。

5. 無料のサンプルを試す

   クレジットがまったくなくても、エージェントはサンプルヘッド20個をダウンロードできるので、パイプラインのほかの部分を先に試せます。

6. 1ヘッド、次にフォルダ

   キャストを作るなら、人物ごとにサブフォルダを作って写真を入れ、キャスト用のプロンプトを貼ります。エージェントがヘッドの数を数え、合計を伝えて、あなたの承認を待ちます。

   プロンプト · 英語コピー

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

   このプロンプトは英語のまま使ってください。エージェントは書かれたとおりのURLを読む必要があります。その後のやり取りは日本語でかまいません。

スキルが実行するもの

スキルは、インストールするパッケージのないPythonファイル1つです（Python 3.9以降）。エージェントが実行しますが、あなたが実行することもできます。以下は、手を加えていないスキル自身のヘルプです。

$ 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人の写真1〜15枚から、サブフォルダごとに1つのヘッドを作り、GLB、FBX、OBJ、STL、PLY、MetaHuman ZIPをダウンロードする。
• 残高を確認し、ヘッドの一覧を出し、もう一度ダウンロードする。
• llms.txtとスキルをもとに、冪等性キーとWebhookハンドラーを備えたパイプラインのスクリプトを書く。

• クレジットの購入や自動チャージの設定：代わりにWebアプリへ案内します。
• あなたの代わりに同意を確認したり、ログインを承認したりすること。
• 子どもや著名人のヘッド、ネットで見つけた写真からのヘッドを作ること。

AIエージェントで作るヘッドについての質問

01どのエージェントで使えますか？

Claude Code、Codex、Cursor、Gemini CLI、OpenClaw、そしてシェルコマンドを実行できるか、URLを取得できるすべてのエージェントです。

02チャットにAPIキーを貼る必要がありますか？

いいえ。ブラウザでコードを承認すれば、スキルがキーをあなたのコンピューターに保管します。キーを表示することはありません。

03エージェントが確認なしでクレジットを使うことはありますか？

作業のたびに費用と残高を先に伝え、5ヘッドを超える場合は止まって確認を待ちます。

04MCPサーバーはありますか？

現時点ではありません。スキルは、エージェントが直接実行するコマンドラインのスクリプトで動きます。