Foto til MetaHuman · API og AI-agenter
Et hode er ett API-kall.
Send foto av en person fra koden din, eller be AI-agenten din gjøre det. Omtrent 4 minutter senere får du et ferdig MetaHuman-hode: personens egen hud i 4K, anbefalinger for groom (MetaHuman-hår), en hals som passer og 52 ARKit-blendshapes, i seks formater. 1 500 kreditter per hode til 0,01 USD per kreditt, og et mislykket hode koster 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.Lim inn i Claude Code, Codex, Cursor, Gemini CLI eller OpenClaw. Du godkjenner en kode; ingen nøkkel å kopiere. La prompten stå på engelsk: agenten din trenger nettadressen nøyaktig slik den er skrevet. Etterpå kan du snakke 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/faceninjaGir deg hodets id med en gang. Vi kaller webhooken din når det er ferdig.
- 0,01 USD per kreditt, betal etter bruk
- 1 500 kreditter per hode, alle filer inkludert
- Ingen abonnement
- Mislykkede hoder refunderes
- 1MetaHuman-topologiSamme vertexrekkefølge og UV-er på hvert hode.
- 2Øyne og tennerSatt inn i hulene sine; irisfarge fra fotoet.
- 3Hud i 4KGrunnfarge, normal, cavity, specular/roughness.
- 452 ARKit-blendshapesLaget for dette ansiktet, tongueOut inkludert.
- 5En hals som passerHals og trapezius følger personen.
Inn: ett foto. Ut: dette hodet, uredigert. En syntetisk person.
Dra, eller fokuser og bruk ← →- Inndata
- 1 fotoopptil 15 av én person
- Topologi
- MetaHumanhode, hals, skuldre
- Uttrykk
- 52 ARKitlaget for ansiktet
- Hudkart
- 4 × 4Kfarge, normal, cavity, spec/rough
- Kjøretid
- omtrent 4 minper hode, uansett hvordan du starter
- Pris
- 0,01 USDper kreditt · 1 500 per hode
Hvert kall gir et ferdig hode, ikke et skallet mesh.
Automatisering lønner seg bare hvis ingen må ferdigstille resultatet for hånd. Dette er hva hvert hode inneholder, enten det kommer fra API-et, en agent eller nettappen, uten ekstra kostnad.
- Ansiktet, i MetaHuman-topologi. Hode, hals og skuldre, øyne og tenner. Samme vertexrekkefølge og UV-er på hvert hode, så én rigg passer til alle.
- Personens egen hud. 4K-kart for grunnfarge, normal, cavity og specular/roughness, i MetaHumans UV-layout.
- Hår, bryn, vipper og skjegg, med navn. Anbefalte MetaHuman-grooms med fargeverdier, som
groom.jsonverktøyene dine kan lese. - En hals som passer. Halsen og trapezius følger personens egne proporsjoner.
- 52 ARKit-blendshapes. Laget for dette ansiktet,
tongueOutinkludert, klare for ansiktssporing og lipsync. - Seks formater. GLB, FBX, OBJ, STL, PLY og en MetaHuman ZIP. Be om hvilket som helst av dem, så ofte du vil.
Fire vanskelige foto
Hardt lys, dype linjer
Den oransje fargestikken er borte fra huden; rynkene blir igjen som relieff.
Latter og briller
Latteren er ikke bakt inn i formen.
Fullskjegg, hodet vendt
Kjeven er gjenskapt; skjegget kommer tilbake som groom.
Hår over ørene
Ansiktet er hennes; ørenes form hentes ikke fra fotoet.
Ingen av disse personene finnes. Vi genererte fotoene for å kunne teste uten noens ansikt. Hodene er nøyaktig det som kom ut.
Se eksemplene.
Hvert hode her er laget av FaceNinja fra ett foto og vises akkurat slik det kom ut. Flere eksempler kommer, med flere typer ansikter, lys og hår.
Prøv uttrykkene på et hode API-et har laget.
Dette er den samme lette forhåndsvisningen som nettappen viser for hvert hode. Hver knapp styrer hodets egne ARKit-blendshapes. Slå på hårforhåndsvisningen for å vurdere likheten med hår.
Eksempelhoder
Piltastene dreier hodet. Pluss og minus zoomer. Null tilbakestiller visningen. Escape forlater visningen.
ARKit-verdier
Verdiene følger uttrykket. Dra i en glider for å sette én blendshape.
Ett hode eller fem hundre, samme kall.
Et hode tar omtrent 4 minutter, så FaceNinja er asynkront fra første stund. Du sender, du får svar, du henter. Alt som gjør det trygt å kjøre en batch uten tilsyn, ligger i API-et, og agent-skillen bruker det samme API-et.
Agenten din kan gjøre det.
- Opprett en konto. Opprett en konto med Google eller e-posten din, og kjøp kreditter.
- Lim inn én prompt i Claude Code, Codex, Cursor, Gemini CLI eller OpenClaw.
- Godkjenn koden agenten din viser deg på
faceninja.net/device.
Be så om mer: «ett hode per undermappe i ./cast», «alle hodene på nytt som FBX», «skriv en webhook-pipeline til meg». Skillen sier fra om kostnaden og saldoen din før den bruker kreditter, og spør før den lager mer enn 5 hoder.
Koden din kan gjøre det.
- Idempotency-nøkler. Prøv en oppretting på nytt med samme nøkkel, så får du samme hode og blir aldri belastet to ganger.
- Signerte webhooks.
head.completedoghead.failed, signert iFaceNinja-Signature. Eller en strøm av server-sent events, eller?waitfor skript. - Plass til batcher. 30 hodeopprettinger og 600 forespørsler i minuttet, per konto.
- Feil du kan styre koden etter. Stabile koder som
no_faceognot_same_person, hver med et hint. - Refusjon uten supportsaker. Kreditter reserveres når hodet opprettes, og frigis av seg selv hvis hodet mislykkes.
- Lenker, ikke vedlegg. Hver fil kommer som en signert lenke med kort levetid. Lagre id-en til hodet og spør på nytt når du trenger den.
POST /v1/headsfoto av én person- hode-id
head.completedsignert webhook når det er ferdigPOST /v1/heads/{id}/filesformat- signert lenke med kort levetid
Unreal-automatisering, som tilpasser ansiktet, setter huden, legger på grooms og velger en kropp inne i Unreal Engine, er i tidlig tilgang. Be om tilgang Tidlig tilgang
Fire typer pipelines, én type hode.
Verktøy og plattformer
Legg til «lag et hode fra et foto» i produktet ditt. Webhooks inn, signerte lenker ut, refusjon uten supportsaker.
Utviklere
Spillstudioer
Spilleransikter eller et rollegalleri av NPC-er, alt på ett mesh, så én rigg og ett materiale passer til hvert hode.
Hoder til spill
Folk som jobber med agenter
Gi jobben til Claude Code, Codex eller Cursor: et rollegalleri fra en mappe, FBX for hvert hode, et pipeline-skript.
Bruk med AI-agenter
Tekniske artister
Åpne MetaHuman Creator med tilpasningen, huden og groomene allerede avgjort.
Innhold i et hode0,01 USD per kreditt, uansett hvordan du ber om det.
API-et, agenten din og nettappen trekker fra én saldo til én pris. Kjøp kreditter i en pakke eller i et valgfritt beløp, uten abonnement. Et hode koster 1 500 kreditter, og hvis det mislykkes, kommer kreditene tilbake av seg selv. Salgsskatt eller moms legges til i kassen der det gjelder.
Ett hode, i nettleseren.
Du trenger ingen agent eller API-nøkkel. Logg inn med Google, last opp ett til 15 foto av én person, og last ned hodet om omtrent 4 minutter. Nettappen viser 3D-forhåndsvisningen med uttrykk og hår før du laster ned.
Før du automatiserer.
- 01Må jeg skrive kode?
- Nei. Lim inn én prompt i en AI-agent som Claude Code eller Cursor, eller bruk nettappen i nettleseren. Bruk med AI-agenter
- 02Hvor lang tid tar et hode?
- Omtrent 4 minutter fra opplasting. Når mange hoder venter, havner ditt i kø, og API-et melder hvilken plass det har i køen.
- 03Hvor mange foto trenger jeg?
- Ett skarpt foto er nok. Opptil 15 foto av samme person hjelper, særlig en profil og en halvprofil. Fototips
- 04Hva skjer hvis et hode mislykkes?
- Hodets 1 500 kreditter går tilbake til saldoen din av seg selv, og
error.codesier hvorfor, for eksempelno_face. - 05Er håret en del av hodet?
- Nei. I MetaHuman er hår, bryn og skjegg grooms. Vi anbefaler de riktige, med fargene deres, som data verktøyene dine kan lese.
- 06Hvilke foto kan jeg bruke?
- Dine egne, eller foto av en voksen som har sagt ja til at det lages et 3D-hode av vedkommende. Vi lager ikke hoder av barn, og heller ikke fra foto som er funnet på nettet. Akseptabel bruk EN
- 07Hva skjer med fotoene mine?
- De slettes etter 30 dager, og du kan slette et hode og fotoene til det tidligere. Personvernerklæring EN
Det første hodet ditt er én prompt unna.
Opprett en konto, kjøp kreditter, lim inn prompten og godkjenn koden.