TRELLIS.2 4B | EmpirioLabs AI Docs

Microsoft · 3D Generation

POST /v1/3d/generations

TRELLIS.2 image-to-3D model that turn a reference image into a textured GLB asset with resolution, seed, mesh, texture, and export controls.

في لمحة

الميدان	القيمة
النموذج	`trellis-2-4b`
تاريخ الإفراج النموذجي	-
طرائق المدخلات	الصورة
طرائق النواتج	3D
نافذة السياق	-
دقة الوزن	BF16/FP16 مختلطة
المعالم	image_to_3d, glb_output, pbr_materials, seed_control, commercial_ready
Native inference	نعم
جديدة	نعم
نقاط النهاية المدعومة	`POST /v1/3d/generations`

الطباعة

الرسم	Spec	المعدل
512 من الأصول	لكل طلب	$0.025 (كان $0.25)
1024 من الأصول	لكل طلب	$0.249 (كان $0.30)
1536 الأصول	لكل طلب	$0.499

طلب مثال

$ curl https://api.empiriolabs.ai/v1/3d/generations \
>   -H 'Authorization: Bearer $EMPIRIOLABS_API_KEY' \
>   -H 'Content-Type: application/json' \
>   -d '{"model": "trellis-2-4b", "image_url": "https://example.com/product-photo.png", "resolution": "1024", "texture_size": "2048"}'

البارامترات

البارامترات	النوع	المطلوبة	التقصير	الوصف
`image`	صورة	نعم	-	(ب) الصورة المرجعية لليوران، أو الأشعة فوق البنفسجية، أو الجسم المحمل للصور.
`resolution`	enum	لا	`"1024"`	دقة شبكة الفوكسل. القيم الأعلى أبطأ وأكثر تفصيلا. · مسموح به: `512`، `1024`، `1536`
`pipeline_type`	enum	لا	`"1024_cascade"`	خط أنابيب تريليس الصريح. غادر على خط 1024 إلا إذا كنت بحاجة إلى مسار 512 أو 1536. · مسموح به: `512`، `1024_cascade`، `1536_cascade`
`seed`	integer	لا	`42`	البذور النادرة لأجيال قابلة للتكاثر الرنج: صفر - 2147483647
`preprocess_image`	boolean	لا	صحيح	إزالة الخلفية وتطبيع الصورة المرجعية قبل الجيل.
`max_num_tokens`	integer	لا	`49152`	الحد الأقصى للدبابات مستعملة لجيل التعاقب الرنج: 1024 - 131072
`ss_sampling_steps`	integer	لا	`12`	خطوات (سامبلر) لتوليد الهيكل الرنج: 1 - 64
`ss_guidance_strength`	العدد	لا	`7.5`	القوة الإرشادية لتوليد هيكل متفرقة الرنج: صفر - 20
`ss_guidance_rescale`	العدد	لا	`0.7`	(ج) إعادة جدولة الإرشادات من أجل توليد هيكل متفرقة. الرنج: صفر - 2
`ss_guidance_interval_start`	العدد	لا	`0.6`	ابدأي من فترة التوجيه الرنج: صفر - 1
`ss_guidance_interval_end`	العدد	لا	`1`	نهاية فترة التوجيه الرنج: صفر - 1
`ss_rescale_t`	العدد	لا	`5`	إعادة تحديد درجة الحرارة لتوليد البنية الرنج: صفر - 20
`shape_slat_sampling_steps`	integer	لا	`12`	خطوات (سامبلر) لتشكيل جيل متأخّر منظم الرنج: 1 - 64
`shape_slat_guidance_strength`	العدد	لا	`7.5`	القوة الإرشادية للجيل المتأخر المنظم الرنج: صفر - 20
`shape_slat_guidance_rescale`	العدد	لا	`0.5`	إعادة جدولة الإرشادات للجيل المتأخر المنظم الرنج: صفر - 2
`shape_slat_guidance_interval_start`	العدد	لا	`0.6`	ابدأي بتشكيل “إرشاد “سلات الرنج: صفر - 1
`shape_slat_guidance_interval_end`	العدد	لا	`1`	نهاية النموذج الإرشادي SLat الرنج: صفر - 1
`shape_slat_rescale_t`	العدد	لا	`3`	إعادة تحديد درجة الحرارة لتوليد متخلف منظم. الرنج: صفر - 20
`tex_slat_sampling_steps`	integer	لا	`12`	خطوات (سامبلر) من أجل الجيل المتأخر الرنج: 1 - 64
`tex_slat_guidance_strength`	العدد	لا	`1`	القوة الإرشادية للجيل المتأخر المنظم. الرنج: صفر - 20
`tex_slat_guidance_rescale`	العدد	لا	`0`	:: إعادة جدولة الإرشادات المتعلقة بالتوليد المتأخر المنظم. الرنج: صفر - 2
`tex_slat_guidance_interval_start`	العدد	لا	`0.6`	ابدأي في توجيه النسيج الرنج: صفر - 1
`tex_slat_guidance_interval_end`	العدد	لا	`0.9`	نهاية فترة توجيه “سلات” الرنج: صفر - 1
`tex_slat_rescale_t`	العدد	لا	`3`	Rescale temperature for texture structured latent generation. الرنج: صفر - 20
`texture_size`	enum	لا	`"2048"`	دقة الملمس مخزنة على مادة GLB. · مسموح به: `1024`، `2048`، `4096`
`decimation_target`	integer	لا	`500000`	الرقم التقريبي لللافقاريات المصدّرة الرنج: 000 10 - 000 1
`remesh`	boolean	لا	صحيح	إعادة بناء طبوغرافيا الميشي قبل أن يكشف الأشعة فوق البنفسجية ويبكي
`remesh_band`	العدد	لا	`1`	حجم الفرقة الرنج: صفر - 5
`remesh_project`	العدد	لا	`0.9`	عامل الإسقاط المستخدم أثناء إعادة التنظيف. الرنج: صفر - 1
`uv_unwrap_angle_threshold_deg`	العدد	لا	`90`	(كون نصف زاوية) تستخدم في التكتل غير المتعمد الرنج: 1 - 180
`uv_unwrap_refine_iterations`	integer	لا	`0`	أشعة فوق البنفسجية الرنج: صفر - 10
`uv_unwrap_global_iterations`	integer	لا	`1`	Global UV clustering iterations. الرنج: صفر - 10
`uv_unwrap_smooth_strength`	العدد	لا	`1`	قوة الأشعة فوق البنفسجية الرنج: صفر - 10
`response_format`	enum	لا	`"url"`	أعيد عناوين URL الموقعة للوسائط بشكل افتراضي، أو ب JSON base64 الداخلي عند الطلب. · مسموح: `url`، `b64_json`
`verbose`	boolean	لا	كاذب	قطع الأشجار التصديرية القابلة للانفجار

الحواشي

** المتأخرات**

خط الأنابيب للسلاسل التعاقبية
12 درجة لكل مرحلة
2048 حجم النسيج
هدف إزالة الألغام من 500 كيلوغرام
الناتج GLB

** مراقبون**

:: دعم الصور أو الحمولة، 512/1024 /1536 القرار، البذور، خط الأنابيب، العينة EL guidance/interval /rescale controls, texture size, mesh decimation, remeshing, UV unwrap tuning, and URL or base64 output. بيلينغ هو من أصل 3D متولد.

مخطط Machine قابل للقراءة: GET https://api.empiriolabs.ai/v1/models/trellis-2-4b.