TRELLIS.2 4B | EmpirioLabs AI Docs

Microsoft · 3D Generation

POST /v1/3d/generations

TRELLIS.2 图像转3D模型，将参考图像转换为带有分辨率、种子、网格、纹理和导出控制的纹理GLB资产。

一眼看

场地	价值
型号ID	`trellis-2-4b`
车型发布日期	-
输入模态	图片
输出模态	3D
上下文窗口	-
重量精度	混合的BF16/FP16
特色	image_to_3d，glb_output，pbr_materials，seed_control，commercial_ready
本土推断	是的
新	是的
支持的端点	`POST /v1/3d/generations`

定价

冲锋	规格	速率
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`	图片	是的	-	引用图片URL、数据URI或上传的图片对象。
`resolution`	枚举	不	`"1024"`	体素网格分辨率。高数值则更慢且细节更丰富。·允许：`512`，`1024`，`1536`
`pipeline_type`	枚举	不	`"1024_cascade"`	显式TRELLIS管道。除非你需要512或1536路径，否则建议走1024级联。·允许：`512`，`1024_cascade`，`1536_cascade`
`seed`	整数	不	`42`	随机种子用于可重复的世代。·射程：0 – 2147483647
`preprocess_image`	布尔值	不	确实如此	去除背景并在生成前对参考图像进行归一化。
`max_num_tokens`	整数	不	`49152`	用于级联生成的最大稀疏令牌。·距离：1024 – 131072
`ss_sampling_steps`	整数	不	`12`	稀疏结构生成的采样步骤。·范围：1 – 64
`ss_guidance_strength`	人数	不	`7.5`	稀疏结构生成的导引强度。·射程：0 – 20
`ss_guidance_rescale`	人数	不	`0.7`	为稀疏结构生成提供引导重标。·射程：0 – 2
`ss_guidance_interval_start`	人数	不	`0.6`	稀疏结构引导区间的开始。·射程：0 – 1
`ss_guidance_interval_end`	人数	不	`1`	稀疏结构指导区间结束。·射程：0 – 1
`ss_rescale_t`	人数	不	`5`	重新调整温度以实现稀疏结构生成。·射程：0 – 20
`shape_slat_sampling_steps`	整数	不	`12`	形状结构化潜在生成的采样步骤。·范围：1 – 64
`shape_slat_guidance_strength`	人数	不	`7.5`	形状结构潜生成的指导强度。·射程：0 – 20
`shape_slat_guidance_rescale`	人数	不	`0.5`	形状结构潜生成的指导重标。·射程：0 – 2
`shape_slat_guidance_interval_start`	人数	不	`0.6`	形状开始 SLat 引导间隔。·射程：0 – 1
`shape_slat_guidance_interval_end`	人数	不	`1`	形状结束，SLat导引间隔。·射程：0 – 1
`shape_slat_rescale_t`	人数	不	`3`	形状结构潜生成的温度重新缩放。·射程：0 – 20
`tex_slat_sampling_steps`	整数	不	`12`	纹理结构化潜在生成的采样步骤。·范围：1 – 64
`tex_slat_guidance_strength`	人数	不	`1`	结构性潜生成的指导强度。·射程：0 – 20
`tex_slat_guidance_rescale`	人数	不	`0`	纹理结构潜在生成的引导重缩放。·射程：0 – 2
`tex_slat_guidance_interval_start`	人数	不	`0.6`	纹理SLat引导区间的起始。·射程：0 – 1
`tex_slat_guidance_interval_end`	人数	不	`0.9`	纹理SLat引导区间结束。·射程：0 – 1
`tex_slat_rescale_t`	人数	不	`3`	纹理结构潜生成的缩放温度。·射程：0 – 20
`texture_size`	枚举	不	`"2048"`	纹理分辨率烘焙到GLB材质上。·允许：`1024`，`2048`，`4096`
`decimation_target`	整数	不	`500000`	导出网格的目标顶点数近似值。·范围：10000 – 10000000
`remesh`	布尔值	不	确实如此	在UV展开和纹理烘焙之前，先重建网格拓扑。
`remesh_band`	人数	不	`1`	重新网状的频段大小。·射程：0 – 5
`remesh_project`	人数	不	`0.9`	重网格时使用的投影因子。·射程：0 – 1
`uv_unwrap_angle_threshold_deg`	人数	不	`90`	用于UV展开聚类的锥半角阈值。·范围：1 – 180
`uv_unwrap_refine_iterations`	整数	不	`0`	紫外聚类细化迭代。·范围：0 – 10
`uv_unwrap_global_iterations`	整数	不	`1`	全局紫外聚类迭代。·范围：0 – 10
`uv_unwrap_smooth_strength`	人数	不	`1`	紫外线聚块平滑强度。·范围：0 – 10
`response_format`	枚举	不	`"url"`	默认返回签名媒体URL，或在请求时返回内联base64 JSON。·允许：`url`，`b64_json`
`verbose`	布尔值	不	错误	启用详细网格导出日志。

注释

默认情况

1024级联管道
每阶段12个采样器步骤
2048 纹理尺寸
50万振制目标
GLB输出

控制

支持图片URL或上传，512/1024/1536分辨率，种子，流水线类型，采样器guidance/interval/缩放控制，纹理大小，网格减级，重新网格，UV展开调优，以及URL或base64输出。计费是按生成的3D资产计算的。

Machine可读模式： GET https://api.empiriolabs.ai/v1/models/trellis-2-4b。