FaceNinja

Panduan · Claude Code · Codex · Cursor · Gemini CLI · OpenClaw

Buat kepala 3D dari Claude Code, Codex atau Cursor.

Agen pemrograman AI dapat membuat kepala MetaHuman: satu kepala dari foto, sekumpulan dari folder, FBX untuk semua kepala Anda, atau skrip untuk pipeline. Panduan ini membahas penggunaan pertama, pertanyaan agen, serta kemampuan dan batasnya.

Penggunaan pertama, langkah demi langkah

  1. Tempel satu prompt

    Buka agen di folder foto lalu tempel ini. Bekerja pada agen yang dapat menjalankan perintah shell atau mengambil URL; halaman agen memiliki versi untuk masing-masing.

    Prompt · Inggris
    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.

    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.

  2. Setujui kode masuk

    Agen menampilkan kode singkat dan membuka faceninja.net/device. Masuk di sana lalu setujui kodenya. Kunci API tidak ditempel di percakapan; skill menyimpannya di komputer dan tidak pernah mencetaknya.

  3. Pastikan Anda berhak memakai foto

    Sebelum kepala pertama, agen menampilkan pernyataan untuk dikonfirmasi dengan kata-kata sendiri: Anda berhak memakai foto, setiap orang setuju dan dewasa, serta Anda mengikuti Kebijakan Konten dan Kemiripan EN. Agen tidak pernah mengonfirmasi untuk Anda.

  4. Agen menyebut biaya terlebih dulu

    Agen memeriksa saldo dan memberi tahu biaya kepala serta sisa saldo sebelum membelanjakan apa pun. Untuk lebih dari lima kepala, agen berhenti dan meminta konfirmasi total.

  5. Coba sampel gratis

    Tanpa kredit pun agen dapat mengunduh 20 kepala sampel agar Anda menguji sisa pipeline terlebih dahulu.

  6. Satu kepala, lalu satu folder

    Untuk sekumpulan orang, taruh foto tiap orang dalam subfolder sendiri lalu tempel prompt cast. Agen menghitung kepala, menyebut total dan menunggu persetujuan Anda.

    Prompt · Inggris
    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>.

    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.

Yang dijalankan skill

Skill ini satu berkas Python tanpa paket yang perlu dipasang (Python 3.9 atau lebih baru). Agen menjalankannya; Anda juga bisa. Ini teks bantuannya sendiri tanpa suntingan:

Shell
$ python3 faceninja.py --help
usage: faceninja.py [-h] [--json] [--base BASE] [--version] COMMAND ...

FaceNinja: photos in, MetaHuman head out.

positional arguments:
  COMMAND
    login      sign in by approving a code in the browser
    whoami     who is signed in
    balance    credits left and what a head costs
    make       make one head from 1-15 photos of one person
    status     where a head stands
    download   download a finished head's files
    batch      one head per photo, or per subfolder with --per-person-
               subfolders
    samples    the free sample heads: list them, or --download ID|all (no
               credits)
    list       your heads, newest first
    logout     revoke and forget the saved key
    update     update the skill now (it also updates itself at most hourly)
    guidance   the server's current rules and notices for agents
    attest     the user confirms, once per computer, that they may use the
               photos (asked before the first head)

options:
  -h, --help   show this help message and exit
  --json       one JSON object on stdout, progress on stderr
  --base BASE  API server (default $FACENINJA_API_BASE or
               https://faceninja.net)
  --version    show program's version number and exit

Yang bisa dan tidak bisa dilakukan agen

  • Membuat kepala dari 1–15 foto satu orang, satu kepala per subfolder, dan mengunduh GLB, FBX, OBJ, STL, PLY atau MetaHuman ZIP.
  • Memeriksa saldo, menampilkan daftar kepala dan mengunduhnya lagi.
  • Menulis skrip pipeline dengan kunci idempotensi dan penangan webhook dari llms.txt dan skill.
  • Membeli kredit atau mengaktifkan isi ulang otomatis: agen mengarahkan Anda ke aplikasi web.
  • Mengonfirmasi persetujuan atau menyetujui proses masuk untuk Anda.
  • Membuat kepala anak, tokoh publik atau dari foto yang ditemukan daring.

Pertanyaan tentang kepala dari agen AI

01Agen mana yang bekerja?
Claude Code, Codex, Cursor, Gemini CLI dan OpenClaw, serta agen apa pun yang dapat menjalankan perintah shell atau mengambil URL.
02Apakah kunci API ditempel di percakapan?
Tidak. Anda menyetujui kode dalam peramban dan skill menyimpan kunci di komputer. Kuncinya tidak pernah dicetak.
03Bisakah agen membelanjakan tanpa bertanya?
Agen memberi tahu biaya dan saldo sebelum tiap pekerjaan, serta berhenti untuk konfirmasi jika lebih dari lima kepala.
04Apakah ada server MCP?
Belum. Skill bekerja lewat skrip baris perintah yang dijalankan langsung oleh agen.

Buat MetaHuman dari foto Anda sendiri.

Daftar gratis, unduh kepala contoh, dan buat kepala dari foto Anda sendiri saat paket berbayar dibuka.