Crie cabeças 3D pelo Claude Code, Codex ou Cursor.

A primeira execução, passo a passo

1. Cole um prompt

   Abra o seu agente na pasta com a sua foto e cole isto. Funciona em qualquer agente que consiga rodar um comando de shell ou abrir uma URL; a página de agentes tem uma versão para cada um.

   Prompt · inglêsCopiar prompt

   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.

   Mantenha este prompt em inglês: seu agente precisa do endereço exatamente como está escrito. Depois, você pode conversar com ele no seu idioma.

2. Aprove o código de login

   O agente mostra um código curto e abre faceninja.net/device. Você entra lá e aprova o código. Nenhuma chave de API é colada no chat; a skill guarda a chave no seu computador e nunca a exibe.

3. Confirme que você pode usar as fotos

   Antes da primeira cabeça, o agente mostra uma declaração para você confirmar com as suas próprias palavras: você tem o direito de usar as fotos e o consentimento de cada pessoa, elas são adultas e você segue a Política de conteúdo e uso de imagem EN. O agente nunca confirma por você.

4. O agente informa o custo primeiro

   Ele consulta o seu saldo e diz quanto custa uma cabeça e quanto sobra antes de gastar qualquer coisa. Para mais de cinco cabeças, ele para e pede que você confirme o total.

5. Teste os exemplos grátis

   Mesmo sem nenhum crédito, o agente pode baixar as 20 cabeças de exemplo, então você pode testar antes o resto do seu pipeline.

6. Uma cabeça, depois uma pasta

   Para um elenco, coloque as fotos de cada pessoa em uma subpasta própria e cole o prompt de elenco. O agente conta as cabeças, informa o total e espera o seu sim.

   Prompt · inglêsCopiar prompt

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

   Mantenha este prompt em inglês: seu agente precisa do endereço exatamente como está escrito. Depois, você pode conversar com ele no seu idioma.

O que a skill executa

A skill é um único arquivo Python sem pacotes para instalar (Python 3.9 ou mais recente). O seu agente o executa; você também pode. Esta é a ajuda dele, sem edição:

$ 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

O que o agente pode e não pode fazer

• Criar cabeças a partir de 1–15 fotos de uma pessoa, uma cabeça por subpasta, e baixar GLB, FBX, OBJ, STL, PLY ou o MetaHuman ZIP.
• Consultar o seu saldo, listar as suas cabeças e baixá-las de novo.
• Escrever um script de pipeline com chaves de idempotência e um handler de webhook, a partir do llms.txt e da skill.

• Comprar créditos ou ativar recargas automáticas: em vez disso, ele manda você para o app web.
• Confirmar o consentimento ou aprovar um login por você.
• Criar cabeças de crianças, de figuras públicas ou a partir de fotos encontradas na internet.

Perguntas sobre cabeças por agentes de IA

01Quais agentes funcionam?

Claude Code, Codex, Cursor, Gemini CLI e OpenClaw, e qualquer agente que consiga rodar um comando de shell ou abrir uma URL.

02Preciso colar uma chave de API no chat?

Não. Você aprova um código no navegador, e a skill guarda a chave no seu computador. Ela nunca a exibe.

03O agente pode gastar sem perguntar?

Ele informa o custo e o seu saldo antes de cada tarefa e para pedindo confirmação acima de cinco cabeças.

04Existe um servidor MCP?

Hoje não. A skill funciona por um script de linha de comando que os agentes executam diretamente.