Skip to main content

3d models

Skin Tokens API

إن تزوير الشخصية يدويًا هو عمل متخصص بطيء. تقوم Skin Tokens بذلك تلقائيًا: أرسل شبكة أحرف GLB واسترجع GLB مع هيكل عظمي مُجهز وأوزان سلخ لكل قمة - $0.30 لكل مهمة، لا يوجد أداة في الحلقة.

ابدأ الآن!

Skin Tokens API Pricing

Pay-as-you-go access through PiAPI.

Auto-Rigmesh2rig

$0.30

Rig one GLB character mesh, up to 80,000 triangles.

ما تفعله الرموز الجلدية

نقطة نهاية واحدة، وظيفة واحدة: تحويل شبكة ثابتة إلى شبكة متحركة.

Rigging بدون أداة

قم بإرسال شبكة شخصية ثلاثية الأبعاد ورموز الجلد التي تناسب الهيكل العظمي وتحل لك أوزان السلخ لكل قمة. الشبكة التي وصلت ثابتة تترك متحركة، بدون تمريرة تزوير يدوية.

GLB داخل، GLB خارج

الإدخال هو glTF 2.0 ثنائي صالح (GLB) لما يصل إلى مثلثات 80 و000، ويتم تقديمه كـ URL الذي يمكن الوصول إليه بشكل عام أو URI للبيانات base64. تقوم الاستجابة بإرجاع GLB المجهز في ملفput.model_file الذي يحتوي على الشبكة الأصلية والهيكل العظمي المجهز وأوزان السلخ.

Flat $0.30 لكل مهمة

تكلف كل مهمة منصة نفس التكلفة بغض النظر عن مدى تعقيد الشبكة، وبالتالي فإن تكلفة تجهيز مكتبة أحرف كاملة يمكن التنبؤ بها قبل البدء.

غير متزامن حسب التصميم

قم بإنشاء مهمة، ثم قم باستقصاء نقطة نهاية الجلب حتى تصل إلى حالة طرفية. لا شيء يمنع سلسلة طلبك أثناء معالجة الشبكة. إشعارات

Webhook

قم بتوفير config.webhook_config.endpoint وسر اختياري لتلقي رد اتصال عند اكتمال المهمة أو فشلها. قم بإلغاء تكرار عمليات الاسترجاعات بواسطة Task_id واجلب المهمة لتأكيد الحالة النهائية. معرفات المفاصل الثابتة

تستخدم مفاصل الهيكل العظمي

معرفات العظام المستقرة من خلال معرفاتbone_N بدون تسميات دلالية، مما يحافظ على التسمية وإعادة الاستهداف البشري تحت سيطرة خط الأنابيب الخاص بك بدلاً من التخمين في الاصطلاحات.

Get started

Create your API key

Sign up and grab an API key from the PiAPI workspace — free credits are included on sign-up.

Top up credits

Add credits on the billing page when you are ready to scale beyond the free tier.

Call the API

POST your first task following the API docs, then poll the task until the result is ready.

Iterate in the playground

Prototype prompts and settings in the the playground above before wiring them into your product.

curl -X POST 'https://api.piapi.ai/api/v1/task' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "Qubico/skin-tokens",
    "task_type": "rig",
    "input": {
      "model": "YOUR_GLB_URL",
      "seed": -1,
      "bone_names": "original"
    }
  }'

# → { "task_id": "9d5a…", "status": "pending" }

الأسئلة المتداولة

ما هي الرموز الجلدية API؟ تعمل رموز

Skin Tokens تلقائيًا على تجهيز شبكة شخصية ثلاثية الأبعاد. تقوم بإرسال شبكة GLB وتتلقى GLB المجهزة التي تحتوي على الشبكة الأصلية، والهيكل العظمي المجهز، وأوزان السلخ لكل قمة الرأس.

ما هي الشبكة التي يمكنني إرسالها؟

ملف glTF 2.0 ثنائي صالح (GLB) لا يزيد عن مثلثات 80 و000، ويتم توفيره إما كـ URL الذي يمكن الوصول إليه بشكل عام أو كـ URI للبيانات الأساسية64. عادةً ما تنتج الشبكة النظيفة التي تشبه الإنسان في الوضع المحايد الأداة الأكثر موثوقية.

كم تكلف؟

$0.30 لكل مهمة على منصة الحفر.

هل تسمى العظام؟

لا. تستخدم مفاصل الهيكل العظمي المستقرةbone_0 من خلال معرفاتbone_N بدون تسميات دلالية. إذا كان خط الأنابيب الخاص بك يحتاج إلى عظام بشرية مسماة، فقم بتعيينها في خطوة إعادة الاستهداف الخاصة بك.

هل API متزامن؟

لا. يعد التثبيت مهمة غير متزامنة: قم بإنشاء المهمة، ثم قم باستقصاء نقطة نهاية الجلب حتى تصل إلى حالة طرفية. يمكنك أيضًا تسجيل خطاف ويب ليتم إعلامك عند اكتمال المهمة أو فشلها.

ماذا تفعل معلمة البذور؟ تعد بذرة

اختيارية ويتم تعيينها افتراضيًا على -1، والتي تستخدم بذرة عشوائية. اضبطها على قيمة ثابتة عندما تريد نتيجة قابلة للتكرار لنفس شبكة الإدخال.

ماذا يحدث إذا فشلت المهمة؟

تصل المهمة إلى حالة فشل طرفية، والتي تلاحظها إما عن طريق استقصاء نقطة نهاية الجلب أو من خلال خطاف الويب الخاص بك. قم بإحضار المهمة لتأكيد الحالة النهائية قبل إعادة المحاولة.

More questions? See the API docs.