De foto a MetaHuman · API y agentes de IA
Una cabeza es una llamada a la API.
Envía fotos de una persona desde tu código, o pídeselo a tu agente de IA. Unos 4 minutos después tienes una cabeza MetaHuman terminada: la piel de la propia persona en 4K, recomendaciones de groom (pelo de MetaHuman), un cuello ajustado y 52 blendshapes ARKit, en seis formatos. 1500 créditos por cabeza a 0,01 US$ el crédito, y una cabeza fallida no cuesta nada.
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.Pégalo en Claude Code, Codex, Cursor, Gemini CLI u OpenClaw. Apruebas un código; no hay clave que copiar. Deja este prompt en inglés: tu agente necesita la dirección web tal cual está escrita. Después puedes hablarle en tu idioma.
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/faceninjaDevuelve al instante el id de la cabeza. Cuando termina, llamamos a tu webhook.
- 0,01 US$ el crédito, pago por uso
- 1500 créditos por cabeza, todos los archivos incluidos
- Sin suscripción
- Reembolso si una cabeza falla
- 1Topología MetaHumanEl mismo orden de vértices y las mismas UV en cada cabeza.
- 2Ojos y dientesEn sus cuencas; el color del iris sale de la foto.
- 3Piel en 4KColor base, normal, cavity y especular/rugosidad.
- 452 blendshapes ARKitHechos para esta cara, tongueOut incluido.
- 5Un cuello que encajaEl cuello y el trapecio siguen a la persona.
Entra: una foto. Sale: esta cabeza, sin retocar. Una persona sintética.
Arrastra, o enfoca y usa ← →- Entrada
- 1 fotohasta 15 de una persona
- Topología
- MetaHumancabeza, cuello, hombros
- Expresiones
- 52 ARKithechas para la cara
- Piel
- 4 × 4Kcolor, normal, cavity, spec/rough
- Duración
- unos 4 minpor cabeza, por cualquier vía
- Tarifa
- 0,01 US$por crédito · 1500 cada cabeza
Cada llamada devuelve una cabeza terminada, no una malla calva.
Automatizar solo compensa si nadie tiene que terminar el resultado a mano. Esto es lo que contiene cada cabeza, venga de la API, de un agente o de la aplicación web, sin coste adicional.
- La cara, en topología MetaHuman. Cabeza, cuello y hombros, ojos y dientes. El mismo orden de vértices y las mismas UV en cada cabeza, así que un solo rig sirve para todas.
- La piel de la propia persona. Mapas 4K de color base, normal, cavity y especular/rugosidad, en la disposición UV de MetaHuman.
- Pelo, cejas, pestañas y barba, con nombre. Recomendaciones de grooms de MetaHuman con valores de color, en un
groom.jsonque tus herramientas pueden leer. - Un cuello que encaja. El cuello y el trapecio siguen las proporciones de la propia persona.
- 52 blendshapes ARKit. Hechos para esta cara,
tongueOutincluido, listos para el seguimiento facial y el lip sync. - Seis formatos. GLB, FBX, OBJ, STL, PLY y un MetaHuman ZIP. Pídelos todos, las veces que quieras.
Cuatro fotos difíciles
Luz dura, arrugas hondas
La dominante naranja desaparece de la piel; las arrugas se quedan como relieve.
Una risa y gafas
La risa no queda grabada en la forma.
Barba y cabeza girada
La mandíbula se recupera; la barba vuelve como groom.
Pelo sobre las orejas
La cara es la suya; la forma de las orejas no se toma de la foto.
Ninguna de estas personas existe. Generamos las fotos para poder probar sin la cara de nadie. Las cabezas son exactamente lo que salió.
Ver las muestras.
Cada cabeza de aquí la hizo FaceNinja a partir de una foto y se muestra tal como salió. Habrá más muestras, con más tipos de caras, de luz y de pelo.
Prueba las expresiones en una cabeza hecha por la API.
Es la misma vista previa ligera que muestra la aplicación web con cada cabeza. Cada botón mueve los blendshapes ARKit de la propia cabeza. Activa la vista previa del pelo para juzgar el parecido con pelo.
Cabezas de muestra
Las flechas giran la cabeza. Más y menos hacen zoom. Cero restablece la vista. Escape cierra el visor.
Valores ARKit
Los valores siguen la expresión. Mueve un control para fijar uno.
Una cabeza o quinientas, la misma llamada.
Una cabeza tarda unos 4 minutos, así que FaceNinja es asíncrono desde el principio. Envías, recibes aviso, descargas. Todo lo que hace seguro ejecutar un lote sin supervisión está en la API, y la skill del agente usa esa misma API.
Tu agente puede hacerlo.
- Crea una cuenta. Crea una cuenta con Google o con tu correo, y compra créditos.
- Pega un prompt en Claude Code, Codex, Cursor, Gemini CLI u OpenClaw.
- Aprueba el código que tu agente te muestra en
faceninja.net/device.
Luego pide más: “una cabeza por subcarpeta de ./cast”, “todas las cabezas otra vez en FBX”, “escríbeme un pipeline con webhooks”. La skill te dice el coste y tu saldo antes de gastar, y pregunta antes de hacer más de 5 cabezas.
Tu código puede hacerlo.
- Claves de idempotencia. Si reintentas una creación con la misma clave, obtienes la misma cabeza, nunca un segundo cobro.
- Webhooks firmados.
head.completedyhead.failed, firmados enFaceNinja-Signature. O un flujo de eventos enviados por el servidor (SSE), o?waitpara scripts. - Espacio para lotes. 30 creaciones de cabezas y 600 solicitudes por minuto, por cuenta.
- Errores que tu código distingue. Códigos estables como
no_faceynot_same_person, cada uno con una pista. - Reembolsos sin tickets. Los créditos se retienen al crear y se liberan solos si una cabeza falla.
- Enlaces, no adjuntos. Cada archivo llega como un enlace firmado de corta duración. Guarda el id de la cabeza y vuelve a pedirlo cuando lo necesites.
POST /v1/headsfotos de una persona- id de la cabeza
head.completedwebhook firmado cuando terminaPOST /v1/heads/{id}/filesformato- enlace firmado de corta duración
La automatización de Unreal, que conforma la cara, aplica la piel, pone los grooms y elige un cuerpo dentro de Unreal Engine, está en acceso anticipado. Pídela Acceso previo
Cuatro tipos de pipeline, un solo tipo de cabeza.
Software y plataformas
Añade “crea una cabeza a partir de una foto” a tu producto. Webhooks de entrada, enlaces firmados de salida, reembolsos sin tickets de soporte.
Desarrollo
Estudios de juegos
Caras de jugadores o un reparto de NPC, todo sobre una misma malla, así que un rig y un material sirven para todas las cabezas.
Cabezas para un juego
Quien trabaja con agentes
Pasa el trabajo a Claude Code, Codex o Cursor: un reparto desde una carpeta, FBX de cada cabeza, un script de pipeline.
Usar agentes de IA
Artistas técnicos
Abre MetaHuman Creator con la cara ya conformada, la piel y los grooms decididos.
Qué incluye una cabeza0,01 US$ el crédito, lo pidas como lo pidas.
La API, tu agente y la aplicación web usan un mismo saldo, a un mismo precio. Compra créditos en un paquete o por cualquier importe, sin suscripción. Una cabeza cuesta 1500 créditos, y si falla, sus créditos vuelven solos. El impuesto sobre las ventas o el IVA se añade al pagar donde corresponda.
Una cabeza, en el navegador.
No necesitas un agente ni una clave de API. Inicia sesión con Google, sube de 1 a 15 fotos de una misma persona y descarga la cabeza en unos 4 minutos. La aplicación web muestra la vista previa 3D con expresiones y pelo antes de que descargues.
Antes de automatizar.
- 01¿Necesito escribir código?
- No. Pega un prompt en un agente de IA como Claude Code o Cursor, o usa la aplicación web en tu navegador. Usar agentes de IA
- 02¿Cuánto tarda una cabeza?
- Unos 4 minutos desde la subida. Si hay muchas cabezas esperando, la tuya entra en cola, y la API informa de su lugar en la fila.
- 03¿Cuántas fotos necesito?
- Con una foto nítida basta. Hasta 15 fotos de la misma persona ayudan, sobre todo un perfil y una vista de tres cuartos. Guía de fotos
- 04¿Qué pasa si una cabeza falla?
- Sus 1500 créditos vuelven a tu saldo solos, y
error.codedice por qué, por ejemplono_face. - 05¿El pelo forma parte de la cabeza?
- No. En MetaHuman, el pelo, las cejas y las barbas son grooms. Recomendamos los adecuados con sus colores, como datos que tus herramientas pueden leer.
- 06¿De quién pueden ser las fotos?
- Tuyas, o de un adulto que aceptó que se haga una cabeza 3D suya. No hacemos cabezas de niños ni a partir de fotos encontradas en internet. Uso aceptable EN
- 07¿Qué pasa con mis fotos?
- Se eliminan después de 30 días, y puedes eliminar una cabeza y sus fotos antes. Política de privacidad EN
Tu primera cabeza está a un prompt de distancia.
Crea una cuenta, compra créditos, pega el prompt y aprueba el código.