מתמונה ל-MetaHuman · API וסוכני AI
ראש הוא קריאת API.
שולחים תמונות של אדם מהקוד שלכם, או מבקשים זאת מסוכן ה-AI. כ-4 דקות אחר כך מתקבל ראש MetaHuman מוגמר: העור של האדם עצמו ב-4K, המלצות groom (שיער MetaHuman), צוואר מותאם ו-52 צורות ARKit, בשישה פורמטים. 1,500 קרדיטים לראש במחיר 0.01 $ לקרדיט, וראש שנכשל לא עולה כלום.
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.מדביקים ב-Claude Code, ב-Codex, ב-Cursor, ב-Gemini CLI או ב-OpenClaw. מאשרים קוד; אין מפתח להעתיק. יש להשאיר את ההנחיה באנגלית: הסוכן צריך את כתובת האתר בדיוק כפי שהיא כתובה. אחר כך אפשר לדבר איתו בשפה שלכם.
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/faceninjaמחזיר את מזהה הראש מיד. כשהראש מוכן אנחנו קוראים ל-webhook שלכם.
- 0.01 $ לקרדיט, תשלום לפי שימוש
- 1,500 קרדיטים לראש, כל הקבצים כלולים
- ללא מנוי
- קרדיטים על ראש שנכשל חוזרים




- 1טופולוגיית MetaHumanאותו סדר קודקודים ואותם UV בכל ראש.
- 2עיניים ושינייםבארובות שלהן; צבע הקשתית מהתמונה.
- 3עור ב-4Kצבע בסיס, נורמל, cavity וספקולר/חספוס.
- 452 צורות ARKitנוצרו עבור הפנים האלה, כולל tongueOut.
- 5צוואר שמתאיםהצוואר והטרפז עוקבים אחרי האדם.
נכנסת תמונה אחת. יוצא הראש הזה, ללא עריכה. אדם סינתטי.
גרירה, או מיקוד ומקשי ← →- קלט
- תמונה אחתעד 15 תמונות של אדם אחד
- טופולוגיה
- MetaHumanראש, צוואר, כתפיים
- הבעות
- 52 ARKitנוצרו עבור הפנים
- מפות עור
- 4 × 4Kצבע, נורמל, cavity וספקולר/חספוס
- זמן ריצה
- כ-4 דקותלראש, בכל מסלול
- תעריף
- 0.01 $לקרדיט · 1,500 לראש
כל קריאה מחזירה ראש מוגמר, לא רשת קירחת.
אוטומציה שווה את זה רק אם אף אחד לא צריך לסיים את התוצאה ידנית. זה מה שיש בכל ראש, מה-API, מסוכן או מאפליקציית הרשת, ללא תשלום נוסף.
- הפנים, בטופולוגיית MetaHuman. ראש, צוואר וכתפיים, עיניים ושיניים. אותו סדר קודקודים ואותם UV בכל ראש, כך שריג אחד מתאים לכולם.
- העור של האדם עצמו. מפות 4K של צבע בסיס, נורמל, cavity וספקולר/חספוס, בפריסת ה-UV של MetaHuman.
- שיער, גבות, ריסים וזקן, בשמות. המלצות groom של MetaHuman עם ערכי צבע, בקובץ
groom.jsonשהכלים שלכם יכולים לקרוא. - צוואר שמתאים. הצוואר והטרפז עוקבים אחרי הפרופורציות של האדם עצמו.
- 52 צורות ARKit. נוצרו עבור הפנים האלה, כולל
tongueOut, מוכנות למעקב פנים ולסנכרון שפתיים. - שישה פורמטים. GLB, FBX, OBJ, STL, PLY ו-MetaHuman ZIP. אפשר לבקש כל אחד מהם, כמה פעמים שרוצים.
ארבע תמונות קשות
אור קשה, קמטים עמוקים


הטיית הצבע הכתומה נעלמה מהעור; הקמטים נשארו כתבליט.
צחוק ומשקפיים


הצחוק לא נאפה לתוך הצורה.
זקן מלא, ראש מסובב


הלסת שוחזרה; הזקן חוזר כ-groom.
שיער מעל האוזניים


הפנים הן שלה; צורת האוזניים לא נלקחת מהתמונה.
אף אחד מהאנשים האלה לא קיים. יצרנו את התמונות כדי לבדוק בלי הפנים של אף אחד. הראשים הם בדיוק מה שיצא.
לצפייה בדוגמאות.
כל ראש כאן נוצר על ידי FaceNinja מתמונה אחת ומוצג בדיוק כפי שיצא. דוגמאות נוספות בדרך, עם עוד סוגי פנים, תאורה ושיער.












מנסים את ההבעות על ראש שה-API יצר.
זו אותה תצוגה מקדימה קלה שאפליקציית הרשת מציגה לכל ראש. כל כפתור מפעיל את צורות ה-ARKit של הראש עצמו. אפשר להפעיל את תצוגת השיער כדי לשפוט את הדמיון עם שיער.
ראשים לדוגמה

מקשי החיצים מסובבים את הראש. פלוס ומינוס מקרבים ומרחיקים. אפס מאפס את המבט. Escape יוצא מהצופה.
ערכי ARKit
הערכים עוקבים אחרי ההבעה. גוררים מחוון כדי לקבוע צורה אחת.
ראש אחד או חמש מאות, אותה קריאה.
ראש לוקח כ-4 דקות, ולכן FaceNinja אסינכרוני מהיסוד. שולחים, מקבלים הודעה, מורידים. כל מה שמאפשר להריץ אצווה ללא השגחה נמצא ב-API, ומיומנות הסוכן משתמשת באותו API.
הסוכן שלכם יכול לעשות את זה.
- פותחים חשבון. פותחים חשבון עם Google או עם כתובת אימייל, וקונים קרדיטים.
- מדביקים הנחיה אחת ב-Claude Code, ב-Codex, ב-Cursor, ב-Gemini CLI או ב-OpenClaw.
- מאשרים את הקוד שהסוכן מציג ב-
faceninja.net/device.
אחר כך מבקשים עוד: “ראש אחד לכל תיקיית משנה של ./cast”, “כל הראשים שוב כ-FBX”, “נא לכתוב לי צינור עבודה עם webhook”. המיומנות מציינת את העלות ואת היתרה לפני שהיא מוציאה קרדיטים, ושואלת לפני יותר מ-5 ראשים.
הקוד שלכם יכול לעשות את זה.
- מפתחות Idempotency. מנסים שוב יצירה עם אותו מפתח ומקבלים את אותו ראש, בלי חיוב שני.
- Webhooks חתומים.
head.completedו-head.failed, חתומים ב-FaceNinja-Signature. או זרם server-sent events, או?waitלסקריפטים. - מקום לאצוות. 30 יצירות ראש ו-600 בקשות בדקה לכל חשבון.
- שגיאות שאפשר להסתעף לפיהן. קודים יציבים כמו
no_faceו-not_same_person, כל אחד עם רמז. - החזרים בלי פניות. הקרדיטים מוקפאים ביצירה ומשתחררים מעצמם אם הראש נכשל.
- קישורים, לא קבצים מצורפים. כל קובץ מגיע כקישור חתום קצר מועד. שומרים את מזהה הראש, ומבקשים שוב כשצריך.
POST /v1/headsתמונות של אדם אחד- מזהה ראש
head.completedwebhook חתום כשהראש מוכןPOST /v1/heads/{id}/filesפורמט- קישור חתום קצר מועד
אוטומציית Unreal, שמתאימה את הפנים, מגדירה את העור, מלבישה את ה-grooms ובוחרת גוף בתוך Unreal Engine, נמצאת בגישה מוקדמת. לבקשת גישה גישה מוקדמת
ארבעה סוגי צינורות עבודה, סוג אחד של ראש.
כלים ופלטפורמות
מוסיפים למוצר שלכם “יצירת ראש מתמונה”. Webhooks פנימה, קישורים חתומים החוצה, החזרים בלי פניות לתמיכה.
מפתחיםאולפני משחקים
פנים של שחקנים או קאסט של דמויות NPC, הכול על רשת אחת, כך שריג אחד וחומר אחד מתאימים לכל ראש.
ראשים למשחקמי שעובדים עם סוכנים
מעבירים את העבודה ל-Claude Code, ל-Codex או ל-Cursor: קאסט מתיקייה, FBX לכל ראש, סקריפט צינור עבודה.
שימוש עם סוכני AI0.01 $ לקרדיט, בכל דרך שמבקשים.
ה-API, הסוכן שלכם ואפליקציית הרשת מושכים מיתרה אחת באותו מחיר. קונים קרדיטים בחבילה או בכל סכום, בלי מנוי. ראש עולה 1,500 קרדיטים, ואם הוא נכשל, הקרדיטים חוזרים מעצמם. מס מכירות או מע״מ מתווספים בקופה במקום שבו הם חלים.
ראש אחד, בדפדפן.
אין צורך בסוכן או במפתח API. מתחברים עם Google, מעלים 1 עד 15 תמונות של אדם אחד, ומורידים את הראש תוך כ-4 דקות. אפליקציית הרשת מציגה תצוגה תלת־ממדית עם הבעות ושיער לפני ההורדה.
לפני שעושים אוטומציה.
- 01צריך לכתוב קוד?
- לא. מדביקים הנחיה אחת בסוכן AI כמו Claude Code או Cursor, או משתמשים באפליקציית הרשת בדפדפן. שימוש עם סוכני AI
- 02כמה זמן לוקח ראש?
- כ-4 דקות מרגע ההעלאה. כשהרבה ראשים ממתינים, הראש שלכם עומד בתור, וה-API מדווח על מקומו בתור.
- 03כמה תמונות צריך?
- תמונה חדה אחת מספיקה. עד 15 תמונות של אותו אדם עוזרות, במיוחד פרופיל ומבט של שלושה רבעים. טיפים לצילום
- 04מה קורה אם ראש נכשל?
- 1,500 הקרדיטים שלו חוזרים ליתרה מעצמם, ו-
error.codeמסביר למה, למשלno_face. - 05האם השיער הוא חלק מהראש?
- לא. ב-MetaHuman, שיער, גבות וזקן הם grooms. אנחנו ממליצים על המתאימים עם הצבעים שלהם, כנתונים שהכלים שלכם יכולים לקרוא.
- 06תמונות של מי מותר להעלות?
- תמונות שלכם, או תמונות של מבוגר או מבוגרת שהסכימו שייווצר מהם ראש תלת־ממדי. אנחנו לא יוצרים ראשים של ילדים או מתמונות שנמצאו ברשת. שימוש מקובל EN
- 07מה קורה לתמונות שלי?
- הן נמחקות אחרי 30 יום, ואפשר למחוק ראש ואת התמונות שלו מוקדם יותר. מדיניות פרטיות EN
הראש הראשון שלכם רחוק הנחיה אחת.
פותחים חשבון, קונים קרדיטים, מדביקים את ההנחיה ומאשרים את הקוד.