FaceNinja
Português (Brasil)
Criar uma conta

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

Seu agente de IA pode criar as cabeças.

Cole um prompt no Claude Code, Codex, Cursor, Gemini CLI ou OpenClaw. Seu agente lê a nossa skill, instala, faz o seu login com um código que você aprova e cria uma cabeça MetaHuman a partir da sua foto. Sem chave para copiar. Cerca de 4 minutos depois, o GLB e o MetaHuman ZIP estão na sua pasta.

Prompt padrão
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.

Troque ./photo.jpg pelo caminho da sua foto. Mantenha o resto em inglês: o agente precisa da URL exatamente como está escrita.

Criar uma contaLer o SKILL.md
  • US$ 0,01 por crédito, pague conforme o uso
  • 1.500 créditos por cabeça, todos os arquivos incluídos
  • A skill pergunta antes de gastar
Três momentos de uma execução

  1. Seu agente mostra um código como WXYZ-2345 e o link faceninja.net/device.

  2. Você abre /device com a sessão iniciada, confere o código e clica em Aprovar.

  3. Seu agente informa o custo e o seu saldo e depois salva o GLB e o MetaHuman ZIP.

Conta, prompt, código.

  1. Crie uma conta.

    Crie uma conta em faceninja.net com o Google ou com o seu e-mail e compre os créditos das cabeças que planeja fazer. A skill informa o custo antes de gastar qualquer coisa.

    Criar uma conta

  2. Cole o prompt.

    Abra o seu agente na pasta que contém a sua foto e cole o prompt acima. O agente baixa o SKILL.md, instala a skill e executa a CLI dela.

  3. Aprove o código.

    O agente mostra um código curto. Abra faceninja.net/device com a sessão iniciada, confira se o código é o mesmo e aprove. O agente continua sozinho.

Você nunca copia uma chave. Se preferir usar uma, crie uma chave de API no app web e defina-a como FACENINJA_API_KEY; a skill a usa e dispensa o código.

Prompts para trabalhos de verdade.

Cada prompt cita a URL da skill, então funciona em uma sessão nova, sem nada instalado. Troque os caminhos pelos seus. Os prompts ficam em inglês em todas as versões de idioma deste site, porque o agente precisa ler as URLs e os nomes de arquivo exatamente. Depois, você ainda pode conversar com o seu agente no seu idioma.

01 · Uma cabeça de uma foto Padrão

Sua primeira cabeça, ou um teste rápido.

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.

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.

02 · Um elenco de uma pasta

Uma subpasta por pessoa, de 1 a 15 fotos em cada.

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

Um elenco com mais de 5 cabeças sempre para e espera o seu sim. A skill é feita assim; o prompt só deixa isso explícito. 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.

03 · FBX de cabeças já criadas

Baixe de novo em outro formato. Nada novo é criado nem cobrado.

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.

Os arquivos ficam disponíveis por 30 dias depois que a cabeça termina. 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.

04 · Script de pipeline webhook

Seu agente escreve a integração; você revisa e executa.

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.

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.

05 · Consultar o saldo

Antes de um trabalho grande, ou quando uma execução parou.

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.

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.

Onde colar.

O mesmo prompt funciona em todos estes. Só muda o lugar onde você o cola.

Abra um terminal na pasta do seu projeto, execute claude e cole o 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.

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.

Ou instale primeiro a skill para este agente e depois peça:

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.

Instala em ~/.claude/skills/faceninja (ou $CLAUDE_CONFIG_DIR/skills). Sessões novas a carregam sozinhas.

Claude Code, Codex, Cursor, Gemini CLI e OpenClaw são marcas comerciais de seus proprietários. O FaceNinja não é afiliado a eles.

Ou instale a skill antes.

Pedir que o seu agente leia o SKILL.md é o caminho mais rápido. Se preferir instalar a skill você mesmo, ou se o seu agente não consegue buscar URLs, use uma destas opções.

macOS e Linux

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

Windows (PowerShell)

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

ZIP

Baixe a skill e descompacte onde o seu agente guarda as skills.

Baixar ZIP

Leia primeiro

O SKILL.md é texto simples. Leia, ou peça ao seu agente que o resuma, antes de executar qualquer coisa.

Abrir SKILL.md

Leia um script antes de enviá-lo para um shell. Os dois instaladores são curtos; abra o install.sh EN ou o install.ps1 EN para ver o que eles fazem.

O que você precisa: Python 3 para a CLI, que é um único arquivo sem dependências, e uma conexão com a internet. Mais nada é instalado.

Para agentes que só leem a web: o https://faceninja.net/llms.txt lista a documentação, o arquivo OpenAPI e a skill em um formato que os modelos de linguagem leem bem.

O que o seu agente pode pedir.

A skill é uma camada fina sobre a API do FaceNinja. Seu agente pode fazer o que a API faz, com as verificações abaixo já incluídas.

Fazer o seu login

Com um código que você aprova em faceninja.net/device, ou com FACENINJA_API_KEY.

Criar cabeças

De 1 a 15 fotos de cada pessoa, uma cabeça ou uma pasta inteira de pessoas.

Esperar por elas

Uma cabeça leva cerca de 4 minutos. A skill espera até ela terminar ou falhar.

Baixar qualquer formato

GLB, FBX, OBJ, STL, PLY ou o MetaHuman ZIP, com ou sem os 52 blendshapes ARKit.

Buscar cabeças anteriores

Baixe outro formato de uma cabeça que você já criou, enquanto os arquivos são mantidos (30 dias).

Mostrar o seu saldo

Os créditos restantes e quantas cabeças eles pagam.

Toda cabeça que a skill cria é uma cabeça completa do FaceNinja: mapas de pele 4K, recomendações de groom (cabelo do MetaHuman), um pescoço ajustado e 52 blendshapes ARKit. Conteúdo da cabeça

Ela pergunta antes de gastar.

  • Primeiro o custo. Antes de qualquer cabeça, a skill diz quanto ela custa e quanto resta no seu saldo.
  • Lotes esperam um sim. Mais de 5 cabeças de uma vez, e a skill para e pergunta.
  • Cabeças com falha são reembolsadas. Se uma cabeça falhar, os 1.500 créditos dela voltam ao seu saldo automaticamente, e o erro diz o motivo.
  • Nenhuma chave no seu chat. O login por código dá acesso à skill sem que uma chave apareça no seu prompt ou no seu histórico. Você aprova cada novo login pessoalmente.
  • Você escolhe o teto. A skill só pode gastar créditos que você comprou. Não há assinatura nem nada para cancelar.
  • As fotos são excluídas após 30 dias. A CLI as envia do seu disco para o FaceNinja. Se o seu agente também olha para elas, isso depende do agente e do seu prompt.
  • Só rostos que disseram sim. Use fotos suas ou de adultos que concordaram. Nada de crianças, nada de fotos da internet. Uso aceitável EN

Perguntas sobre agentes.

01Preciso de uma chave de API?
Não. O agente mostra um código e você o aprova em faceninja.net/device. Se a sua configuração não consegue mostrar um código, por exemplo um job em servidor, crie uma chave de API no app web e defina FACENINJA_API_KEY.
02Com quais agentes funciona?
Claude Code, Codex, Cursor, Gemini CLI e OpenClaw, e qualquer agente que consiga executar um comando de shell ou buscar uma URL.
03Quanto custa a skill?
Nada. Uma cabeça custa 1.500 créditos (US$ 15), o mesmo que no app web e na API.
04Posso escrever o prompt no meu idioma?
Sim, ao redor das URLs. Mantenha https://faceninja.net/skill/SKILL.md e os caminhos dos seus arquivos exatamente como estão, e o agente segue o resto em qualquer idioma que entenda.
05Meu agente pode montar um pipeline inteiro?
Pode. O prompt 4 acima pede que ele escreva um com webhooks e chaves de idempotência. A página Desenvolvedores e a referência da API EN também foram escritas para que um agente possa lê-las.
06Existe um servidor MCP?
Hoje não. A skill e o llms.txt cobrem os agentes listados acima. Escreva para nós se o seu agente só fala MCP.
07O agente vê as minhas fotos?
A CLI da skill as envia direto do seu disco. Seu agente vê os nomes dos arquivos e os resultados. Se você pedir que ele olhe uma foto, ele olha, pelo próprio provedor.
08Para onde vão os arquivos?
Para onde o seu prompt disser. O prompt padrão usa ./faceninja-out.

Indo além.

A API

Webhooks, chaves de idempotência e lotes, para quando o pipeline roda sem um agente.

Para devs

A referência

Todos os endpoints, campos e erros, mais um arquivo OpenAPI 3.1.

Docs da API EN

Uma cabeça, sem código

Envie uma foto pelo navegador.

Abrir o app web

Um prompt. Uma cabeça pronta.

Criar uma conta