Foto ke MetaHuman · API dan agen AI
Satu kepala 3D, satu panggilan API.
Kirim foto seseorang dari kode Anda, atau minta agen AI Anda yang mengirimnya. Sekitar 4 menit kemudian, Anda mendapat kepala MetaHuman yang sudah jadi: kulit asli orang itu dalam 4K, rekomendasi groom (rambut MetaHuman), leher yang pas, dan 52 blendshape ARKit, dalam enam format. 1.500 kredit per kepala dengan harga US$0,01 per kredit, dan kepala yang gagal tidak dikenai biaya.
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.Tempel ke Claude Code, Codex, Cursor, Gemini CLI, atau OpenClaw. Anda menyetujui sebuah kode; tidak ada kunci yang perlu disalin. Biarkan prompt ini dalam bahasa Inggris: agen Anda memerlukan alamat web persis seperti yang tertulis. Setelah itu, Anda bisa berbicara dengannya dalam bahasa Anda sendiri.
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/faceninjaLangsung mengembalikan id kepala. Kami memanggil webhook Anda saat selesai.
- US$0,01 per kredit, bayar sesuai pemakaian
- 1.500 kredit per kepala, semua file termasuk
- Tanpa langganan
- Kredit kepala yang gagal dikembalikan




- 1Topologi MetaHumanUrutan vertex dan UV yang sama di setiap kepala.
- 2Mata dan gigiTerpasang di soketnya; warna iris dari foto.
- 3Kulit dalam 4KWarna dasar, normal, cavity, specular/roughness.
- 452 blendshape ARKitDibuat khusus untuk wajah ini, termasuk tongueOut.
- 5Leher yang pasLeher dan trapezius mengikuti proporsi orangnya.
Input: satu foto. Output: kepala ini, tanpa diubah. Orang sintetis.
Seret, atau fokus + panah ← →- Input
- 1 fotohingga 15 foto satu orang
- Topologi
- MetaHumankepala, leher, bahu
- Ekspresi
- 52 ARKitdibuat untuk wajah ini
- Map kulit
- 4 × 4Kwarna, normal, cavity, spec/rough
- Waktu proses
- sekitar 4 menitper kepala, lewat cara apa pun
- Tarif
- US$0,01per kredit · 1.500 per kepala
Setiap panggilan mengembalikan kepala yang sudah jadi, bukan mesh gundul.
Otomatisasi baru berguna kalau tidak ada yang perlu menyelesaikan hasilnya secara manual. Inilah isi setiap kepala, baik dari API, agen, maupun aplikasi web, tanpa biaya tambahan.
- Wajah, dalam topologi MetaHuman. Kepala, leher dan bahu, mata, dan gigi. Urutan vertex dan UV yang sama di setiap kepala, jadi satu rig cocok untuk semuanya.
- Kulit asli orang itu. Map warna dasar, normal, cavity, dan specular/roughness 4K, dalam layout UV MetaHuman.
- Rambut, alis, bulu mata, dan jenggot, lengkap dengan namanya. Rekomendasi groom MetaHuman beserta nilai warnanya, sebagai
groom.jsonyang bisa dibaca tool Anda. - Leher yang pas. Leher dan trapezius mengikuti proporsi asli orang itu.
- 52 blendshape ARKit. Dibuat untuk wajah ini, termasuk
tongueOut, siap untuk face tracking dan lip sync. - Enam format. GLB, FBX, OBJ, STL, PLY, dan MetaHuman ZIP. Minta yang mana saja, sesering yang Anda mau.
Empat foto sulit
Sinar keras, kerut dalam


Bias warna oranye hilang dari kulit; kerutannya tetap ada sebagai relief.
Tertawa dan kacamata


Tawanya tidak ikut tertanam dalam bentuk kepala.
Jenggot lebat, menoleh


Rahangnya dipulihkan; jenggotnya kembali sebagai groom.
Rambut menutupi telinga


Wajahnya tetap miliknya; bentuk telinga tidak diambil dari foto.
Tak satu pun dari orang-orang ini nyata. Kami membuat fotonya sendiri agar bisa menguji tanpa memakai wajah siapa pun. Kepala-kepalanya persis seperti hasil yang keluar.
Lihat contohnya.
Setiap kepala di sini dibuat FaceNinja dari satu foto dan ditampilkan persis seperti hasilnya. Contoh lain akan menyusul, dengan lebih banyak jenis wajah, cahaya, dan rambut.












Coba ekspresinya pada kepala yang dibuat API.
Ini pratinjau ringan yang sama dengan yang ditampilkan aplikasi web untuk setiap kepala. Setiap tombol menggerakkan blendshape ARKit milik kepala itu sendiri. Aktifkan pratinjau rambut untuk menilai kemiripan dengan rambutnya.
Kepala contoh

Tombol panah memutar kepala. Plus dan minus untuk zoom. Nol mereset tampilan. Escape menutup penampil.
Bacaan ARKit
Nilai mengikuti ekspresi. Seret slider untuk mengatur satu shape.
Satu kepala atau 500, panggilannya sama.
Satu kepala butuh sekitar 4 menit, jadi FaceNinja bersifat asinkron sejak awal. Anda kirim, Anda dikabari, Anda ambil. Semua yang membuat sebuah batch aman dijalankan tanpa pengawasan ada di API, dan skill agen memakai API yang sama.
Agen Anda bisa melakukannya.
- Buat akun. Buat akun dengan Google atau e-mail Anda, lalu beli kredit.
- Tempel satu prompt ke Claude Code, Codex, Cursor, Gemini CLI, atau OpenClaw.
- Setujui kodenya yang ditampilkan agen Anda di
faceninja.net/device.
Lalu minta yang lain: “satu kepala per subfolder ./cast”, “semua kepala sekali lagi sebagai FBX”, “buatkan saya pipeline webhook”. Skill ini memberi tahu biaya dan saldo Anda sebelum membelanjakan kredit, dan bertanya dulu sebelum membuat lebih dari 5 kepala.
Kode Anda bisa melakukannya.
- Kunci idempotensi. Ulangi pembuatan dengan kunci yang sama dan Anda mendapat kepala yang sama, tanpa tagihan kedua.
- Webhook bertanda tangan.
head.completeddanhead.failed, ditandatangani diFaceNinja-Signature. Atau aliran server-sent event, atau?waituntuk skrip. - Ruang untuk batch. 30 pembuatan kepala dan 600 permintaan per menit per akun.
- Error yang bisa ditangani lewat kode. Kode stabil seperti
no_facedannot_same_person, masing-masing dengan petunjuk. - Pengembalian tanpa tiket dukungan. Kredit ditahan saat pembuatan dan dilepas dengan sendirinya jika kepala gagal.
- Tautan, bukan lampiran. Setiap file datang sebagai tautan bertanda tangan berumur pendek. Simpan id kepalanya, minta lagi saat Anda memerlukannya.
POST /v1/headsfoto satu orang- id kepala
head.completedwebhook bertanda tangan saat selesaiPOST /v1/heads/{id}/filesformat- tautan bertanda tangan berumur pendek
Otomatisasi Unreal, yang mencocokkan wajah, mengganti kulit, memasang groom, dan memilih body di dalam Unreal Engine, tersedia dalam akses awal. Minta aksesnya Akses awal
Empat jenis pipeline, satu jenis kepala.
Tool dan platform
Tambahkan “buat kepala dari foto” ke produk Anda. Webhook masuk, tautan bertanda tangan keluar, pengembalian tanpa tiket dukungan.
DeveloperStudio game
Wajah pemain atau jajaran NPC, semuanya pada satu mesh, sehingga satu rig dan satu material cocok untuk setiap kepala.
Kepala 3D untuk gamePengguna agen AI
Serahkan pekerjaannya ke Claude Code, Codex, atau Cursor: satu cast dari sebuah folder, FBX untuk setiap kepala, skrip pipeline.
Pakai dengan agen AITechnical artist
Buka MetaHuman Creator dengan conform, kulit, dan groom yang sudah ditentukan.
Isi kepala 3DUS$0,01 per kredit, lewat jalur mana pun.
API, agen Anda, dan aplikasi web memakai satu saldo dengan satu harga. Beli kredit dalam paket atau jumlah berapa pun, tanpa langganan. Satu kepala 1.500 kredit, dan jika gagal, kreditnya kembali dengan sendirinya. Pajak penjualan atau PPN ditambahkan saat checkout jika berlaku.
Satu kepala, di browser.
Anda tidak perlu agen atau kunci API. Masuk dengan Google, masukkan satu sampai 15 foto satu orang, lalu unduh kepalanya dalam sekitar 4 menit. Aplikasi web menampilkan pratinjau 3D dengan ekspresi dan rambut sebelum Anda mengunduh.
Sebelum Anda mengotomatiskan.
- 01Apakah saya perlu menulis kode?
- Tidak. Tempel satu prompt ke agen AI seperti Claude Code atau Cursor, atau pakai aplikasi web di browser Anda. Pakai dengan agen AI
- 02Berapa lama satu kepala 3D selesai?
- Sekitar 4 menit sejak diunggah. Saat banyak kepala sedang menunggu, kepala Anda masuk antrean, dan API melaporkan urutannya.
- 03Berapa foto yang saya perlukan?
- Satu foto yang tajam sudah cukup. Hingga 15 foto orang yang sama membantu, terutama tampak samping dan tampak tiga perempat. Tips foto
- 04Apa yang terjadi jika sebuah kepala gagal?
- 1.500 kreditnya kembali ke saldo Anda dengan sendirinya, dan
error.codemenjelaskan penyebabnya, misalnyano_face. - 05Apakah rambut termasuk dalam kepala?
- Tidak. Di MetaHuman, rambut, alis, dan jenggot adalah groom. Kami merekomendasikan yang tepat beserta warnanya, sebagai data yang bisa dibaca tool Anda.
- 06Foto siapa yang boleh saya pakai?
- Foto diri Anda sendiri, atau foto orang dewasa yang setuju dibuatkan kepala 3D darinya. Kami tidak membuat kepala anak-anak atau dari foto yang ditemukan di internet. Penggunaan yang dapat diterima EN
- 07Apa yang terjadi pada foto saya?
- Foto dihapus setelah 30 hari, dan Anda bisa menghapus sebuah kepala beserta fotonya lebih cepat. Kebijakan privasi EN
Kepala pertama Anda tinggal satu prompt lagi.
Buat akun, beli kredit, tempel prompt, lalu setujui kodenya.