FaceNinja
Español
Crear una cuenta

Agentes de IA · Claude Code, Codex, Cursor, Gemini CLI, OpenClaw

Tu agente de IA puede hacer las cabezas.

Pega un prompt en Claude Code, Codex, Cursor, Gemini CLI u OpenClaw. Tu agente lee nuestra skill, la instala, inicia tu sesión con un código que apruebas tú y crea una cabeza MetaHuman a partir de tu foto. Sin clave que copiar. Unos 4 minutos después, el GLB y el MetaHuman ZIP están en tu carpeta.

Prompt por defecto
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.

Cambia ./photo.jpg por la ruta de tu foto. Deja el resto en inglés: el agente necesita la URL exactamente como está escrita.

Crear una cuentaLeer SKILL.md
  • 0,01 US$ el crédito, pago por uso
  • 1500 créditos por cabeza, todos los archivos incluidos
  • La skill pregunta antes de gastar
Tres momentos de una ejecución

  1. Tu agente muestra un código como WXYZ-2345 y el enlace faceninja.net/device.

  2. Abres /device con la sesión iniciada, compruebas el código y pulsas Aprobar.

  3. Tu agente indica el coste y tu saldo, y luego guarda el GLB y el MetaHuman ZIP.

Cuenta, prompt, código.

  1. Crea una cuenta.

    Crea una cuenta en faceninja.net con Google o con tu correo, y compra los créditos de las cabezas que planeas hacer. La skill te dice el coste antes de gastar nada.

    Crear una cuenta

  2. Pega el prompt.

    Abre tu agente en la carpeta que contiene tu foto y pega el prompt de arriba. El agente descarga SKILL.md, instala la skill y ejecuta su CLI.

  3. Aprueba el código.

    El agente te muestra un código corto. Abre faceninja.net/device con la sesión iniciada, comprueba que el código coincide y apruébalo. El agente sigue solo.

Nunca copias una clave. Si prefieres usar una, crea una clave de API en la aplicación web y configúrala como FACENINJA_API_KEY; la skill la usa y se salta el código.

Prompts para trabajos reales.

Cada prompt incluye la URL de la skill, así que funciona en una sesión nueva sin nada instalado. Cambia las rutas por las tuyas. Los prompts se quedan en inglés en todos los idiomas de este sitio, porque el agente debe leer las URL y los nombres de archivo tal cual. Después puedes seguir hablando con tu agente en tu idioma.

01 · Una cabeza desde una foto Estándar

Tu primera cabeza, o una prueba rápida.

Prompt · inglés
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.

02 · Un reparto desde una carpeta

Una subcarpeta por persona, de 1 a 15 fotos en cada una.

Prompt · inglés
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>.

Un reparto de más de 5 cabezas siempre se detiene a esperar tu sí. La skill está hecha así; el prompt solo lo hace explícito. Deja este prompt en inglés: tu agente necesita la dirección web tal cual está escrita. Después puedes hablarle en tu idioma.

03 · FBX de cabezas ya creadas

Vuelve a descargar en otro formato. No se crea ni se cobra nada nuevo.

Prompt · inglés
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.

Los archivos siguen disponibles durante 30 días después de que termine una cabeza. Deja este prompt en inglés: tu agente necesita la dirección web tal cual está escrita. Después puedes hablarle en tu idioma.

04 · Un pipeline con webhooks

Tu agente escribe la integración; tú la revisas y la ejecutas.

Prompt · inglés
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.

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

05 · Consultar el saldo

Antes de un trabajo grande, o cuando una ejecución se detuvo.

Prompt · inglés
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.

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

Dónde pegarlo.

El mismo prompt funciona en todos. Solo cambia dónde lo pegas.

Abre una terminal en la carpeta de tu proyecto, ejecuta claude y pega el prompt.

Prompt · inglés
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.

O instala primero la skill para este agente y luego pide:

Prompt · inglés
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.

Se instala en ~/.claude/skills/faceninja (o $CLAUDE_CONFIG_DIR/skills). Las sesiones nuevas la cargan solas.

Claude Code, Codex, Cursor, Gemini CLI y OpenClaw son marcas comerciales de sus propietarios. FaceNinja no está afiliada a ellos.

O instala primero la skill.

Pedirle a tu agente que lea SKILL.md es lo más rápido. Si prefieres instalar la skill tú mismo, o tu agente no puede descargar URLs, usa una de estas opciones.

macOS y Linux

Shell
curl -fsSL https://faceninja.net/skill/install.sh | sh

Windows (PowerShell)

PowerShell
irm https://faceninja.net/skill/install.ps1 | iex

ZIP

Descarga la skill y descomprímela donde tu agente guarda las skills.

Descargar ZIP

Léelo primero

SKILL.md es texto plano. Léelo, o pídele a tu agente que lo resuma, antes de ejecutar nada.

Abrir SKILL.md

Lee un script antes de pasarlo a un shell. Los dos instaladores son cortos; abre install.sh EN o install.ps1 EN para ver qué hacen.

Qué necesitas: Python 3 para la CLI, que es un solo archivo sin dependencias, y conexión a internet. No se instala nada más.

Para agentes que solo leen la web: https://faceninja.net/llms.txt lista la documentación, el archivo OpenAPI y la skill en una forma que los modelos de lenguaje leen bien.

Qué puede pedir tu agente.

La skill es una capa fina sobre la API de FaceNinja. Tu agente puede hacer lo que hace la API, con las comprobaciones de abajo ya incluidas.

Iniciar tu sesión

Con un código que apruebas en faceninja.net/device, o con FACENINJA_API_KEY.

Crear cabezas

A partir de 1 a 15 fotos de cada persona, una cabeza o una carpeta entera de personas.

Esperarlas

Una cabeza tarda unos 4 minutos. La skill espera hasta que termina o falla.

Descargar cualquier formato

GLB, FBX, OBJ, STL, PLY o el MetaHuman ZIP, con o sin los 52 blendshapes ARKit.

Recuperar cabezas anteriores

Descarga otro formato de una cabeza que ya creaste, mientras se conservan sus archivos (30 días).

Mostrar tu saldo

Los créditos que quedan y para cuántas cabezas alcanzan.

Cada cabeza que crea la skill es una cabeza completa de FaceNinja: mapas de piel 4K, recomendaciones de groom (pelo de MetaHuman), un cuello ajustado y 52 blendshapes ARKit. Qué incluye una cabeza

Pregunta antes de gastar.

  • Primero, el coste. Antes de cada cabeza, la skill te dice cuánto cuesta y cuánto saldo te queda.
  • Los lotes esperan tu sí. Si son más de 5 cabezas a la vez, la skill se detiene y pregunta.
  • Las cabezas fallidas se reembolsan. Si una cabeza falla, sus 1500 créditos vuelven a tu saldo solos, y el error dice por qué.
  • Sin claves en tu chat. El inicio de sesión con código da acceso a la skill sin que una clave aparezca nunca en tu prompt ni en tu historial. Tú apruebas cada inicio de sesión nuevo.
  • Tú pones el tope. La skill solo puede gastar créditos que compraste. No hay suscripción ni nada que cancelar.
  • Las fotos se eliminan después de 30 días. La CLI las sube desde tu disco a FaceNinja. Que tu agente también las mire depende del agente y de tu prompt.
  • Solo rostros que dijeron que sí. Usa fotos tuyas o de adultos que dieron su consentimiento. Nada de niños ni de fotos de internet. Uso aceptable EN

Preguntas sobre agentes.

01¿Necesito una clave de API?
No. El agente te muestra un código y tú lo apruebas en faceninja.net/device. Si tu entorno no puede mostrarte un código, por ejemplo un trabajo de servidor, crea una clave de API en la aplicación web y configura FACENINJA_API_KEY.
02¿Con qué agentes funciona?
Con Claude Code, Codex, Cursor, Gemini CLI y OpenClaw, y con cualquier agente que pueda ejecutar un comando de shell o descargar una URL.
03¿Cuánto cuesta la skill?
Nada. Una cabeza cuesta 1500 créditos (15 US$), igual que en la aplicación web y la API.
04¿Puedo escribir el prompt en mi idioma?
Sí, alrededor de las URL. Deja https://faceninja.net/skill/SKILL.md y tus rutas de archivo exactamente como están, y el agente seguirá el resto en cualquier idioma que entienda.
05¿Puede mi agente montar un pipeline entero?
Sí. El prompt 4 de arriba le pide que escriba uno con webhooks y claves de idempotencia. La página de Desarrollo y la referencia de la API EN están escritas para que un agente también pueda leerlas.
06¿Hay un servidor MCP?
Hoy no. La skill y llms.txt cubren los agentes de arriba. Escríbenos si tu agente solo habla MCP.
07¿El agente ve mis fotos?
La CLI de la skill las sube directamente desde tu disco. Tu agente ve los nombres de archivo y los resultados. Si le pides que mire una foto, lo hará, a través de su propio proveedor.
08¿Adónde van los archivos?
Adonde diga tu prompt. El prompt por defecto usa ./faceninja-out.

Ir más allá.

La API

Webhooks, claves de idempotencia y lotes, para cuando el pipeline funciona sin agente.

Desarrollo

La referencia

Cada endpoint, campo y error, además de un archivo OpenAPI 3.1.

Referencia API EN

Una cabeza, sin código

Sube una foto en el navegador.

Abrir la app web

Un prompt. Una cabeza terminada.

Crear una cuenta