من صورة إلى MetaHuman · API ووكلاء AI
الرأس استدعاء API، لا أكثر.
تُرسَل صور الشخص من شيفرتك، أو يتولى ذلك وكيل الذكاء الاصطناعي. وبعد نحو 4 دقائق يصلك رأس MetaHuman جاهز: بشرة الشخص نفسه بدقة 4K، وتوصيات groom (شعر MetaHuman)، ورقبة مطابقة، و52 شكلًا من أشكال ARKit، بستة تنسيقات. 1,500 وحدة للرأس بسعر 0.01 US$ للوحدة، والرأس الفاشل لا يكلّف شيئًا.
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 US$ للوحدة، والدفع حسب الاستخدام
- 1,500 وحدة للرأس، وكل الملفات مشمولة
- بلا اشتراك
- وحدات الرأس الفاشل تعود إليك
- 1طوبولوجيا MetaHumanترتيب النقاط نفسه وUV نفسها في كل رأس.
- 2العينان والأسنانفي محاجرها، ولون القزحية من الصورة.
- 3البشرة بدقة 4Kاللون الأساسي وnormal وcavity وspecular/roughness.
- 452 شكلًا من ARKitمصنوعة لهذا الوجه، ومنها tongueOut.
- 5رقبة مطابقةالرقبة والعضلة شبه المنحرفة تتبعان الشخص.
المُدخل: صورة واحدة. المُخرج: هذا الرأس، دون تعديل. شخص اصطناعي.
للتحريك: السحب أو ← →- الإدخال
- صورة واحدةحتى 15 صورة لشخص واحد
- الطوبولوجيا
- MetaHumanالرأس والرقبة والكتفان
- التعابير
- 52 ARKitمصنوعة لهذا الوجه
- خرائط البشرة
- 4 × 4Kاللون وnormal وcavity وspec/rough
- مدة التشغيل
- نحو 4 دقائقلكل رأس، بأي طريقة
- السعر
- 0.01 US$للوحدة · 1,500 للرأس
كل استدعاء يُعيد رأسًا جاهزًا، لا شبكة صلعاء.
لا تستحق الأتمتة العناء إلا إذا لم يضطر أحد إلى إكمال النتيجة يدويًا. هذا ما يحتويه كل رأس، من API أو من وكيل أو من تطبيق الويب، دون أي تكلفة إضافية.
- الوجه، بطوبولوجيا MetaHuman. الرأس والرقبة والكتفان، والعينان والأسنان. ترتيب النقاط نفسه وUV نفسها في كل رأس، فيناسبها جميعًا rig واحد.
- بشرة الشخص نفسه. خرائط 4K للون الأساسي وnormal وcavity وspecular/roughness، بتخطيط 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. أو تدفق أحداث يرسلها الخادم، أو?waitللسكربتات. - متّسع للدفعات. 30 عملية إنشاء رأس و600 طلب في الدقيقة لكل حساب.
- أخطاء تتفرع عليها الشيفرة. رموز ثابتة مثل
no_faceوnot_same_person، ولكلٍّ منها تلميح. - استرداد دون تذاكر دعم. تُحجز الوحدات عند الإنشاء، وتُحرَّر تلقائيًا إذا فشل الرأس.
- روابط لا مرفقات. يأتي كل ملف برابط موقّع قصير الأجل. يكفي حفظ معرّف الرأس وطلب الرابط مجددًا عند الحاجة.
POST /v1/headsصور شخص واحد- معرّف الرأس
head.completedwebhook موقّع عند الانتهاءPOST /v1/heads/{id}/filesالتنسيق- رابط موقّع قصير الأجل
أتمتة Unreal، التي تطابق الوجه وتضبط البشرة وتضيف الـ groom وتختار جسمًا داخل Unreal Engine، متاحة في الوصول المبكر. طلب الوصول وصول مبكر
أربعة أنواع من خطوط الإنتاج، ونوع واحد من الرؤوس.
الأدوات والمنصات
ميزة «إنشاء رأس من صورة» داخل منتجك: webhooks للإشعار، وروابط موقّعة للتسليم، واسترداد دون تذاكر دعم.
المطوّرون
استوديوهات الألعاب
وجوه اللاعبين أو طاقم من شخصيات NPC، كلها على شبكة واحدة، فيناسب كل رأس rig واحد ومادة واحدة.
رؤوس للعبة
مَن يعمل مع الوكلاء
تسليم المهمة إلى Claude Code أو Codex أو Cursor: طاقم من مجلد، أو FBX لكل رأس، أو سكربت لخط الإنتاج.
الاستخدام مع وكلاء الذكاء الاصطناعي
0.01 US$ للوحدة، أيًّا كانت طريقة الطلب.
يسحب API ووكيلك وتطبيق الويب من رصيد واحد وبسعر واحد. تُشترى الوحدات في باقة أو بأي مبلغ، دون اشتراك. والرأس 1,500 وحدة، وإذا فشل عادت وحداته تلقائيًا. وتُضاف ضريبة المبيعات أو ضريبة القيمة المضافة عند الدفع حيث تنطبق.
رأس واحد، في المتصفح.
لا حاجة إلى وكيل أو مفتاح API. تسجيل الدخول عبر Google، ثم رفع ما بين صورة واحدة و15 صورة لشخص واحد، وتنزيل الرأس بعد نحو 4 دقائق. ويعرض تطبيق الويب المعاينة ثلاثية الأبعاد مع التعابير والشعر قبل التنزيل.
قبل الأتمتة.
- 01هل أحتاج إلى كتابة شيفرة؟
- لا. يكفي لصق موجّه واحد في وكيل ذكاء اصطناعي مثل Claude Code أو Cursor، أو استخدام تطبيق الويب في المتصفح. الاستخدام مع وكلاء الذكاء الاصطناعي
- 02كم يستغرق الرأس؟
- نحو 4 دقائق من الرفع. وعندما تنتظر رؤوس كثيرة، يدخل رأسك في طابور، ويُبلغ API عن موضعه فيه.
- 03كم صورة أحتاج؟
- صورة واحدة واضحة تكفي. وتساعد صور أخرى للشخص نفسه، حتى 15 صورة، ولا سيما صورة جانبية وأخرى بزاوية ثلاثة أرباع. نصائح التصوير
- 04ماذا يحدث إذا فشل رأس؟
- تعود وحداته البالغة 1,500 وحدة إلى رصيدك تلقائيًا، ويوضح
error.codeالسبب، مثلno_face. - 05هل الشعر جزء من الرأس؟
- لا. في MetaHuman، الشعر والحواجب واللحى عناصر groom. نوصي بالمناسب منها مع ألوانه، كبيانات تقرؤها أدواتك.
- 06صور من يمكنني استخدامها؟
- صورك أنت، أو صور شخص بالغ وافق على صنع رأس ثلاثي الأبعاد له. لا نصنع رؤوسًا للأطفال، ولا من صور وُجدت على الإنترنت. الاستخدام المقبول EN
- 07ماذا يحدث لصوري؟
- تُحذف بعد 30 يومًا، ويمكنك حذف الرأس وصوره قبل ذلك. سياسة الخصوصية EN
رأسك الأول على بُعد موجّه واحد.
إنشاء حساب وشراء وحدات، ثم لصق الموجّه والموافقة على الرمز.