TRELLIS.2 4B واجهة برمجة التطبيقات

نموذج TRELLIS.2 من الصورة إلى ثلاثية الأبعاد يحول صورة مرجعية إلى أصل GLB مملموس مع دقة، وبذرة، وشبكة، وملمس، وتحكم في التصدير.

Microsoftالتوليد ثلاثي الأبعاداستدلال أصلي

حول TRELLIS.2 4B

نموذج TRELLIS.2 من الصورة إلى ثلاثية الأبعاد يحول صورة مرجعية إلى أصل GLB مملموس مع دقة، وبذرة، وشبكة، وملمس، وتحكم في التصدير.

يعرف أيضا باسم Microsoft TRELLIS.2 4B, TRELLIS.2-4B, trellis-2-4b

image to 3dglb outputpbr materialsseed controlcommercial ready

مواصفات TRELLIS.2 4B

معرّف النموذج
trellis-2-4b
المزود
Microsoft
الفئة
التوليد ثلاثي الأبعاد
تاريخ الإصدار
-
الإدخال
صورة
الإخراج
3D
نقاط النهاية
POST/v1/3d/generations
معرّفات نموذج بديلة
microsoft/trellis.2-4btrellis-2

أسعار واجهة TRELLIS.2 4B APIوفّر حتى 90%

أسعار الدفع حسب الاستخدام مباشرة من كتالوج EmpirioLabs. تدفع فقط مقابل ما تستخدمه، بدون حد أدنى شهري.

النوع
المواصفة
السعر
أصل 512
لكل طلب
$0.25$0.025
أصل 1024
لكل طلب
$0.30$0.249
أصل 1536
لكل طلب
$0.499
قارن في صفحة الأسعار الكاملة

كيفية استدعاء واجهة TRELLIS.2 4B API

يعمل TRELLIS.2 4B عبر POST /v1/3d/generations. يعيد الطلب job_id فورًا؛ استعلم عن GET /v1/jobs/{job_id} حتى تكتمل المهمة ثم اقرأ روابط الإخراج من النتيجة. احصل على مفتاح API من لوحة تحكم EmpirioLabs.

cURL: إرسال المهمة
curl https://api.empiriolabs.ai/v1/3d/generations \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "trellis-2-4b",
    "prompt": "Describe what you want TRELLIS.2 4B to generate."
  }'
cURL: استعلام النتيجة
curl https://api.empiriolabs.ai/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"
Python
import requests

response = requests.post(
    "https://api.empiriolabs.ai/v1/3d/generations",
    headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    json={
        "model": "trellis-2-4b",
        "prompt": "Describe what you want TRELLIS.2 4B to generate.",
    },
)
job = response.json()

# Generation runs as an async job. Poll until it completes.
import time
while True:
    status = requests.get(
        f"https://api.empiriolabs.ai/v1/jobs/{job['job_id']}",
        headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    ).json()
    if status.get("status") in ("completed", "failed"):
        print(status)
        break
    time.sleep(5)
المرجع الكامل لواجهة TRELLIS.2 4B API

معلمات واجهة TRELLIS.2 4B API

معلمات الطلب التي تدعمها واجهة TRELLIS.2 4B API على EmpirioLabs. تُطبق القيم الافتراضية عند حذف أي حقل.

المعاملالنوعالافتراضيالنطاق / القيمالوصف
imageimage--رابط الصورة المرجعية، أو رابط البيانات URI، أو كائن الصورة المرفوع.
resolutionenum1024512, 1024, 1536دقة شبكة الفوكسل. القيم الأعلى أبطأ وأكثر تفصيلا.
pipeline_typeenum1024_cascade512, 1024_cascade, 1536_cascadeخط أنابيب تريليس الصريح. غادر على خط 1024 إلا إذا كنت بحاجة إلى مسار 512 أو 1536.
seedinteger420 إلى 2147483647بذور عشوائية للأجيال القابلة للتكرار.
preprocess_imagebooleantrue-قم بإزالة الخلفية وتطبيع صورة المرجع قبل التوليد.
max_num_tokensinteger491521024 إلى 131072أقصى رموز متناثرة تستخدم لتوليد التسلسل.
ss_sampling_stepsinteger121 إلى 64خطوات السامبلر لتوليد البنية المتفرقة.
ss_guidance_strengthnumber7.50 إلى 20قوة التوجيه لتوليد الهياكل المتفرقة.
ss_guidance_rescalenumber0.70 إلى 2إعادة تدرج التوجيه لتوليد الهياكل المتفرقة.
ss_guidance_interval_startnumber0.60 إلى 1بداية فترة التوجيه للبنية المتفرقة.
ss_guidance_interval_endnumber10 إلى 1نهاية فترة توجيه البنية المتفرقة.
ss_rescale_tnumber50 إلى 20إعادة درجة حرارة القياس لتوليد الهياكل المتفرقة.
shape_slat_sampling_stepsinteger121 إلى 64خطوات العينات لتوليد الكامن المنظم بالشكل.
shape_slat_guidance_strengthnumber7.50 إلى 20قوة التوجيه لتوليد الكامن الهيكلي الشكلي.
21 معلمات إضافية في الوثائق

معلومات مفيدة

الإعدادات الافتراضية - خط أنابيب 1024 المتسلسلة - 12 خطوة سامبلر لكل مرحلة - 2048 حجم الخامة - هدف التدمير 500k - إخراج GLB التحكمات يدعم عنوان URL الصورة أو رفعها، دقة 512/1024/1536، البذرة، نوع خط الأنابيب، ضوابط guidance/interval/إعادة تكبير السامبلر، حجم النسيج، إزالة الشبكة، إعادة التشبيك، ضبط UV unwrap، ومخرجات URL أو base64. الفوترة هي لكل أصل ثلاثي الأبعاد مولد.

واجهة TRELLIS.2 4B API: أسئلة شائعة

كم تكلف واجهة TRELLIS.2 4B API؟

على EmpirioLabs، تتم فوترة TRELLIS.2 4B حسب الاستخدام. جدول الأسعار المباشر في هذه الصفحة يطابق دائمًا ما تحتسبه الواجهة.

أي نقطة نهاية يستخدم TRELLIS.2 4B؟

يُقدَّم TRELLIS.2 4B عبر POST /v1/3d/generations على api.empiriolabs.ai مع مصادقة Bearer القياسية.

هل يمكنني تجربة TRELLIS.2 4B في المتصفح قبل الدمج؟

نعم. يشغّل ملعب EmpirioLabs نموذج TRELLIS.2 4B في المتصفح بنفس المعلمات التي تتيحها الواجهة، لتجربة المطالبات قبل كتابة الكود.

كيف أحصل على مفتاح API لنموذج TRELLIS.2 4B؟

أنشئ حساب EmpirioLabs ثم أنشئ مفتاحًا من API Keys في لوحة التحكم. الفوترة برصيد الدفع حسب الاستخدام، فلا تدفع إلا مقابل الطلبات التي تنفذها.

هل أنت مستعد لاستخدام نقاط نهاية أفضل؟

تحقق من تسعيرنا أو تواصل إذا كنت ترغب في نشر نموذجك الخاص على مجموعتنا.