Crea cabezas 3D desde Claude Code, Codex o Cursor.

La primera ejecución, paso a paso

1. Pega un prompt

   Abre tu agente en la carpeta donde está tu foto y pega esto. Funciona en cualquier agente que pueda ejecutar un comando de shell o abrir una URL; la página de agentes tiene una versión para cada uno.

   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.

   Deja este prompt en inglés: tu agente necesita la dirección web tal cual está escrita. Después puedes hablarle en tu idioma.

2. Aprueba el código de inicio de sesión

   El agente te muestra un código corto y abre faceninja.net/device. Ahí inicias sesión y apruebas el código. No se pega ninguna clave de API en el chat; la skill guarda su clave en tu ordenador y nunca la muestra.

3. Confirma que puedes usar las fotos

   Antes de la primera cabeza, el agente te muestra una declaración para que la confirmes con tus propias palabras: tienes derecho a usar las fotos y el consentimiento de cada persona, son adultos y cumples la Política de contenido y parecido personal EN. El agente nunca la confirma por ti.

4. El agente indica primero el coste

   Consulta tu saldo y te dice cuánto cuesta una cabeza y cuánto te queda antes de gastar nada. Para más de cinco cabezas se detiene y te pide que confirmes el total.

5. Prueba las muestras gratuitas

   Sin ningún crédito, el agente puede descargar las 20 cabezas de muestra, así que puedes probar antes el resto de tu pipeline.

6. Una cabeza, luego una carpeta

   Para un reparto, pon las fotos de cada persona en su propia subcarpeta y pega el prompt de reparto. El agente cuenta las cabezas, indica el total y espera tu sí.

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

   Deja este prompt en inglés: tu agente necesita la dirección web tal cual está escrita. Después puedes hablarle en tu idioma.

Qué ejecuta la skill

La skill es un único archivo de Python sin paquetes que instalar (Python 3.9 o posterior). Tu agente lo ejecuta; tú también puedes. Esta es su propia ayuda, sin editar:

$ 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

Lo que el agente puede y no puede hacer

• Crear cabezas a partir de 1–15 fotos de una persona, una cabeza por subcarpeta, y descargar GLB, FBX, OBJ, STL, PLY o el MetaHuman ZIP.
• Consultar tu saldo, listar tus cabezas y volver a descargarlas.
• Escribir un script de pipeline con claves de idempotencia y un manejador de webhooks, a partir de llms.txt y la skill.

• Comprar créditos o activar recargas automáticas: en su lugar te envía a la aplicación web.
• Confirmar el consentimiento o aprobar un inicio de sesión por ti.
• Crear cabezas de niños, de personajes públicos o a partir de fotos encontradas en internet.

Preguntas sobre cabezas desde agentes de IA

01¿Qué agentes funcionan?

Claude Code, Codex, Cursor, Gemini CLI y OpenClaw, y cualquier agente que pueda ejecutar un comando de shell o abrir una URL.

02¿Tengo que pegar una clave de API en el chat?

No. Apruebas un código en tu navegador y la skill guarda la clave en tu ordenador. Nunca la muestra.

03¿Puede el agente gastar sin preguntar?

Te indica el coste y tu saldo antes de cada trabajo, y se detiene para que confirmes a partir de cinco cabezas.

04¿Hay un servidor MCP?

Hoy no. La skill funciona con un script de línea de comandos que los agentes ejecutan directamente.