Foto till MetaHuman · API och AI-agenter
Ett huvud är ett API-anrop.
Skicka foton av en person från din kod, eller be din AI-agent göra det. Cirka 4 minuter senare har du ett färdigt MetaHuman-huvud: personens egen hud i 4K, rekommendationer för grooms (MetaHuman-hår), en hals som passar och 52 ARKit-shapes, i sex format. 1 500 krediter per huvud till 0,01 US$ per kredit, och ett misslyckat huvud kostar ingenting.
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.Klistra in i Claude Code, Codex, Cursor, Gemini CLI eller OpenClaw. Du godkänner en kod; ingen nyckel att kopiera. Låt prompten vara på engelska: din agent behöver webbadressen exakt som den står. Sedan kan du prata med den på ditt eget språk.
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/faceninjaReturnerar huvudets id direkt. Vi anropar din webhook när det är klart.
- 0,01 US$ per kredit, betala per användning
- 1 500 krediter per huvud, alla filer ingår
- Ingen prenumeration
- Misslyckade huvuden krediteras tillbaka




- 1MetaHuman-topologiSamma vertexordning och UV-layout på varje huvud.
- 2Ögon och tänderPå plats i ögonhålorna; irisfärgen kommer från fotot.
- 3Hud i 4KBasfärg, normal, cavity, specular/roughness.
- 452 ARKit-shapesGjorda för det här ansiktet, tongueOut inräknad.
- 5En hals som passarHals och trapezius följer personen.
In: ett foto. Ut: det här huvudet, orört. En syntetisk person.
Dra, eller välj och använd ← →- Indata
- 1 fotoupp till 15 av en och samma person
- Topologi
- MetaHumanhuvud, hals, axlar
- Uttryck
- 52 ARKitgjorda för ansiktet
- Hudtexturer
- 4 × 4Kfärg, normal, cavity, spec/rough
- Körtid
- cirka 4 minper huvud, oavsett väg in
- Pris
- 0,01 US$per kredit · 1 500 per huvud
Varje anrop ger ett färdigt huvud, inte en kal mesh.
Automatisering lönar sig bara om ingen behöver göra klart resultatet för hand. Det här ingår i varje huvud, från API:et, en agent eller webbappen, utan extra kostnad.
- Ansiktet, i MetaHuman-topologi. Huvud, hals och axlar, ögon och tänder. Samma vertexordning och UV-layout på varje huvud, så en och samma rig passar alla.
- Personens egen hud. Texturer för basfärg, normal, cavity och specular/roughness i 4K, i MetaHumans UV-layout.
- Hår, ögonbryn, ögonfransar och skägg, med namn. Rekommendationer för MetaHuman-grooms med färgvärden, som
groom.jsonsom dina verktyg kan läsa. - En hals som passar. Halsen och trapezius följer personens egna proportioner.
- 52 ARKit-shapes. Gjorda för det här ansiktet,
tongueOutinkluderad, redo för ansiktsspårning och läppsynk. - Sex format. GLB, FBX, OBJ, STL, PLY och en MetaHuman ZIP. Be om vilket som helst av dem, så ofta du vill.
Fyra svåra foton
Hårt ljus, djupa rynkor


Det orange färgsticket är borta ur huden; rynkorna finns kvar som relief.
Skratt och glasögon


Skrattet bakas inte in i formen.
Fullt skägg, vänt huvud


Käken är återskapad; skägget kommer tillbaka som groom.
Hår över öronen


Ansiktet är hennes; öronens form hämtas inte från fotot.
Ingen av de här personerna finns. Vi genererade fotona för att kunna testa utan någons ansikte. Huvudena är precis det som kom ut.
Se exemplen.
Varje huvud här gjordes av FaceNinja av ett enda foto och visas precis som det kom ut. Fler exempel är på väg, med fler sorters ansikten, ljus och hår.












Prova uttrycken på ett huvud som API:et har gjort.
Det här är samma lätta förhandsvisning som webbappen visar för varje huvud. Varje knapp styr huvudets egna ARKit-shapes. Slå på hårförhandsvisningen för att bedöma likheten med hår.
Exempelhuvuden

Piltangenterna vrider huvudet. Plus och minus zoomar. Noll återställer vyn. Escape lämnar visaren.
ARKit-avläsning
Värdena följer uttrycket. Dra i ett reglage för att sätta en shape.
Ett huvud eller femhundra, samma anrop.
Ett huvud tar cirka 4 minuter, så FaceNinja är asynkront från grunden. Du skickar, du får svar, du hämtar. Allt som gör en batch säker att köra utan uppsikt finns i API:et, och agentskillen använder samma API.
Din agent kan göra det.
- Skapa ett konto. Skapa ett konto med Google eller din e-postadress och köp krediter.
- Klistra in en prompt i Claude Code, Codex, Cursor, Gemini CLI eller OpenClaw.
- Godkänn koden som din agent visar dig på
faceninja.net/device.
Be sedan om mer: ”ett huvud per undermapp i ./cast”, ”alla huvuden igen som FBX”, ”skriv en webhook-pipeline åt mig”. Skillen berättar vad det kostar och hur stort ditt saldo är innan den spenderar något, och frågar innan fler än 5 huvuden.
Din kod kan göra det.
- Idempotensnycklar. Försök igen med samma nyckel och du får samma huvud, aldrig en andra debitering.
- Signerade webhooks.
head.completedochhead.failed, signerade iFaceNinja-Signature. Eller en ström av server-sent events, eller?waitför skript. - Plats för batchar. 30 skapade huvuden och 600 anrop i minuten per konto.
- Fel du kan bygga logik på. Stabila koder som
no_faceochnot_same_person, var och en med ett tips. - Återbetalning utan supportärenden. Krediter reserveras när ett huvud skapas och frigörs av sig själva om huvudet misslyckas.
- Länkar, inte bilagor. Varje fil kommer som en kortlivad signerad länk. Spara huvudets id och fråga igen när du behöver filen.
POST /v1/headsfoton av en person- huvudets id
head.completedsignerad webhook när det är klartPOST /v1/heads/{id}/filesformat- kortlivad signerad länk
Unreal-automatisering, som anpassar ansiktet, sätter huden, lägger på grooms och väljer en kropp inne i Unreal Engine, finns i tidig åtkomst. Be om åtkomst Tidig åtkomst
Fyra sorters pipelines, en sorts huvud.
Verktyg och plattformar
Lägg till ”gör ett huvud av ett foto” i din produkt. Webhooks in, signerade länkar ut, återbetalning utan supportärenden.
UtvecklareSpelstudior
Spelares ansikten eller en rollbesättning av NPC:er, alla på en och samma mesh, så att en rig och ett material passar varje huvud.
Huvuden för spelDig som arbetar med agenter
Lämna över jobbet till Claude Code, Codex eller Cursor: en rollbesättning från en mapp, FBX för varje huvud, ett pipelineskript.
Använd med AI-agenterTekniska artister
Öppna MetaHuman Creator med anpassningen, huden och grooms redan bestämda.
Huvudets innehåll0,01 US$ per kredit, vilken väg du än tar.
API:et, din agent och webbappen drar från samma saldo till samma pris. Köp krediter i ett paket eller för valfri summa, utan prenumeration. Ett huvud kostar 1 500 krediter, och om det misslyckas går dess krediter tillbaka av sig själva. Moms eller försäljningsskatt läggs till i kassan där det gäller.
Ett huvud, i webbläsaren.
Du behöver varken agent eller API-nyckel. Logga in med Google, lägg in 1 till 15 foton av en person och ladda ner huvudet efter cirka 4 minuter. Webbappen visar 3D-förhandsvisningen med uttryck och hår innan du laddar ner.
Innan du automatiserar.
- 01Måste jag skriva kod?
- Nej. Klistra in en prompt i en AI-agent som Claude Code eller Cursor, eller använd webbappen i webbläsaren. Använd med AI-agenter
- 02Hur lång tid tar ett huvud?
- Cirka 4 minuter från uppladdning. När många huvuden väntar hamnar ditt i kö, och API:et rapporterar din plats i kön.
- 03Hur många foton behöver jag?
- Ett skarpt foto räcker. Upp till 15 foton av samma person hjälper, särskilt en profil och en halvprofil. Fototips
- 04Vad händer om ett huvud misslyckas?
- Dess 1 500 krediter går tillbaka till ditt saldo av sig själva, och
error.codesäger varför, till exempelno_face. - 05Ingår håret i huvudet?
- Nej. I MetaHuman är hår, ögonbryn och skägg grooms. Vi rekommenderar rätt grooms med deras färger, som data som dina verktyg kan läsa.
- 06Vems foton kan jag använda?
- Dina egna, eller foton av en vuxen som har gått med på att få ett 3D-huvud gjort av sig. Vi gör inga huvuden av barn eller av foton som hittats på nätet. Godtagbar användning EN
- 07Vad händer med mina foton?
- De raderas efter 30 dagar, och du kan radera ett huvud och dess foton tidigare. Integritetspolicy EN
Ditt första huvud är en prompt bort.
Skapa ett konto, köp krediter, klistra in prompten och godkänn koden.