Foto para MetaHuman · API e agentes de IA
Uma cabeça é uma chamada de API.
Envie fotos de uma pessoa pelo seu código, ou peça ao seu agente de IA. Cerca de 4 minutos depois, você recebe uma cabeça MetaHuman pronta: a pele da própria pessoa em 4K, recomendações de groom (cabelo do MetaHuman), um pescoço ajustado e 52 blendshapes ARKit, em seis formatos. São 1.500 créditos por cabeça, a US$ 0,01 o crédito, e uma cabeça que falha não custa 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.Cole no Claude Code, Codex, Cursor, Gemini CLI ou OpenClaw. Você aprova um código; não há chave para copiar. 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.
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/faceninjaDevolve o id da cabeça na hora. Chamamos o seu webhook quando ela ficar pronta.
- US$ 0,01 por crédito, pague conforme o uso
- 1.500 créditos por cabeça, todos os arquivos incluídos
- Sem assinatura
- Cabeças com falha são reembolsadas
- 1Topologia MetaHumanA mesma ordem de vértices e UVs em toda cabeça.
- 2Olhos e dentesNas órbitas; cor da íris tirada da foto.
- 3Pele em 4KCor base, normal, cavity, specular/roughness.
- 452 blendshapes ARKitFeitos para este rosto, tongueOut incluído.
- 5Um pescoço que se ajustaPescoço e trapézio acompanham a pessoa.
Entrada: uma foto. Saída: esta cabeça, sem retoques. Uma pessoa sintética.
Arraste ou foque e use ← →- Entrada
- 1 fotoaté 15 da mesma pessoa
- Topologia
- MetaHumancabeça, pescoço, ombros
- Expressões
- 52 ARKitfeitas para o rosto
- Pele
- 4 × 4Kcor, normal, cavity, spec/rough
- Tempo
- cerca de 4 minpor cabeça, por qualquer via
- Preço
- US$ 0,01por crédito · 1.500 por cabeça
Cada chamada devolve uma cabeça pronta, não uma malha careca.
A automação só vale a pena se ninguém precisar terminar o resultado à mão. Isto é o que toda cabeça contém, pela API, por um agente ou pelo app web, sem custo extra.
- O rosto, na topologia MetaHuman. Cabeça, pescoço e ombros, olhos e dentes. A mesma ordem de vértices e UVs em toda cabeça, então um único rig serve para todas.
- A pele da própria pessoa. Mapas 4K de cor base, normal, cavity e specular/roughness, no layout de UV do MetaHuman.
- Cabelo, sobrancelhas, cílios e barba, com nome. Recomendações de groom do MetaHuman com valores de cor, em um
groom.jsonque as suas ferramentas leem. - Um pescoço que se ajusta. O pescoço e o trapézio seguem as proporções da própria pessoa.
- 52 blendshapes ARKit. Feitos para este rosto,
tongueOutincluído, prontos para rastreamento facial e lip sync. - Seis formatos. GLB, FBX, OBJ, STL, PLY e um MetaHuman ZIP. Peça qualquer um deles, quantas vezes quiser.
Quatro fotos difíceis
Luz dura, rugas fundas
A dominante laranja saiu da pele; as rugas ficam como relevo.
Riso e óculos
O riso não fica gravado na forma.
Barba cheia, de lado
O maxilar é recuperado; a barba volta como groom.
Cabelo sobre as orelhas
O rosto é dela; o formato das orelhas não vem da foto.
Nenhuma dessas pessoas existe. Geramos as fotos para testar sem o rosto de ninguém. As cabeças são exatamente o que saiu.
Veja os exemplos.
Cada cabeça aqui foi feita pelo FaceNinja a partir de uma foto e aparece exatamente como saiu. Mais exemplos virão, com mais tipos de rosto, luz e cabelo.
Teste as expressões em uma cabeça que a API criou.
É a mesma prévia leve que o app web mostra para cada cabeça. Cada botão aciona os blendshapes ARKit da própria cabeça. Ative a prévia do cabelo para avaliar a semelhança com o cabelo.
Cabeças de exemplo
As setas giram a cabeça. Mais e menos dão zoom. Zero redefine a vista. Esc sai do visualizador.
Leitura ARKit
Os valores seguem a expressão. Arraste um slider para definir um.
Uma cabeça ou quinhentas, a mesma chamada.
Uma cabeça leva cerca de 4 minutos, então o FaceNinja é assíncrono desde o início. Você envia, recebe o aviso e busca. Tudo o que torna um lote seguro para rodar sem supervisão está na API, e a skill de agente usa a mesma API.
Seu agente pode fazer isso.
- Crie uma conta. Crie uma conta com o Google ou com o seu e-mail e compre créditos.
- Cole um prompt no Claude Code, Codex, Cursor, Gemini CLI ou OpenClaw.
- Aprove o código que o seu agente mostra em
faceninja.net/device.
Depois, peça mais: “uma cabeça por subpasta de ./cast”, “todas as cabeças de novo em FBX”, “escreva um pipeline com webhook para mim”. A skill informa o custo e o seu saldo antes de gastar e pergunta antes de mais de 5 cabeças.
Seu código pode fazer isso.
- Chaves de idempotência. Repita uma criação com a mesma chave e você recebe a mesma cabeça, nunca uma segunda cobrança.
- Webhooks assinados.
head.completedehead.failed, assinados emFaceNinja-Signature. Ou um fluxo de server-sent events, ou?waitpara scripts. - Espaço para lotes. 30 criações de cabeça e 600 requisições por minuto, por conta.
- Erros que você pode tratar. Códigos estáveis como
no_faceenot_same_person, cada um com uma dica. - Reembolsos sem chamados. Os créditos ficam retidos na criação e são liberados automaticamente se a cabeça falhar.
- Links, não anexos. Cada arquivo vem como um link assinado de curta duração. Guarde o id da cabeça e peça de novo quando precisar.
POST /v1/headsfotos de uma pessoa- id da cabeça
head.completedwebhook assinado quando ficar prontaPOST /v1/heads/{id}/filesformato- link assinado de curta duração
A automação para Unreal, que ajusta o rosto, define a pele, coloca os grooms e escolhe um corpo dentro do Unreal Engine, está em acesso antecipado. Peça acesso Acesso antecipado
Quatro tipos de pipeline, um tipo de cabeça.
Ferramentas e serviços
Inclua “criar uma cabeça a partir de uma foto” no seu produto. Webhooks na entrada, links assinados na saída, reembolsos sem chamados de suporte.
Desenvolvedores
Estúdios de jogos
Rostos de jogadores ou um elenco de NPCs, todos na mesma malha, então um rig e um material servem para toda cabeça.
Cabeças para jogos
Quem trabalha com agentes
Passe o trabalho ao Claude Code, Codex ou Cursor: um elenco a partir de uma pasta, FBX para cada cabeça, um script de pipeline.
Use com agentes de IA
Artistas técnicos
Abra o MetaHuman Creator com o ajuste do rosto, a pele e os grooms já decididos.
Conteúdo da cabeçaUS$ 0,01 por crédito, pelo caminho que você escolher.
A API, o seu agente e o app web usam o mesmo saldo, ao mesmo preço. Compre créditos em um pacote ou em qualquer valor, sem assinatura. Uma cabeça custa 1.500 créditos e, se ela falhar, os créditos voltam automaticamente. Impostos sobre vendas ou IVA são adicionados no checkout, onde se aplicam.
Uma cabeça, no navegador.
Você não precisa de um agente nem de uma chave de API. Entre com o Google, envie de 1 a 15 fotos de uma pessoa e baixe a cabeça em cerca de 4 minutos. O app web mostra a prévia 3D com expressões e cabelo antes do download.
Antes de automatizar.
- 01Preciso escrever código?
- Não. Cole um prompt em um agente de IA como o Claude Code ou o Cursor, ou use o app web no navegador. Use com agentes de IA
- 02Quanto tempo leva uma cabeça?
- Cerca de 4 minutos a partir do envio. Quando há muitas cabeças na espera, a sua entra na fila, e a API informa a posição.
- 03Quantas fotos eu preciso?
- Uma foto nítida basta. Até 15 fotos da mesma pessoa ajudam, principalmente um perfil e uma vista de três quartos. Dicas de foto
- 04O que acontece se uma cabeça falhar?
- Os 1.500 créditos dela voltam ao seu saldo automaticamente, e
error.codediz o motivo, por exemplono_face. - 05O cabelo faz parte da cabeça?
- Não. No MetaHuman, cabelo, sobrancelhas e barbas são grooms. Recomendamos os certos, com as cores, como dados que as suas ferramentas leem.
- 06De quem posso usar as fotos?
- Suas, ou de um adulto que concordou em ter uma cabeça 3D feita dele. Não fazemos cabeças de crianças nem a partir de fotos encontradas na internet. Uso aceitável EN
- 07O que acontece com as minhas fotos?
- Elas são excluídas após 30 dias, e você pode excluir uma cabeça e as fotos dela antes disso. Política de privacidade EN
Sua primeira cabeça está a um prompt de distância.
Crie uma conta, compre créditos, cole o prompt e aprove o código.