TRELLIS.2 图像到-3D模型,将参考图像转化为有文本的GLB资产,具有分辨率,种子,网格,纹理和导出控制.
Microsoft三维生成原生推理TRELLIS.2 图像到-3D模型,将参考图像转化为有文本的GLB资产,具有分辨率,种子,网格,纹理和导出控制.
也称为 Microsoft TRELLIS.2 4B, TRELLIS.2-4B, trellis-2-4b
trellis-2-4b/v1/3d/generationsmicrosoft/trellis.2-4btrellis-2来自 EmpirioLabs 目录的实时按量计费价格。只为实际用量付费，没有月度最低消费。
TRELLIS.2 4B 通过 POST /v1/3d/generations 运行。请求会立即返回 job_id；轮询 GET /v1/jobs/{job_id} 直到任务完成，再从结果中读取输出 URL。 在EmpirioLabs 控制台获取 API 密钥。
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 https://api.empiriolabs.ai/v1/jobs/JOB_ID \
-H "Authorization: Bearer $EMPIRIOLABS_API_KEY"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)EmpirioLabs 上 TRELLIS.2 4B API 支持的请求参数。省略字段时使用默认值。
| 参数 | 类型 | 默认值 | 范围 / 值 | 描述 |
|---|---|---|---|---|
| image | image | - | - | 引用图片URL、数据URI或上传的图片对象。 |
| resolution | enum | 1024 | 512, 1024, 1536 | 体素网格分辨率。高数值则更慢且细节更丰富。 |
| pipeline_type | enum | 1024_cascade | 512, 1024_cascade, 1536_cascade | 显式TRELLIS管道。除非你需要512或1536路径，否则建议走1024级联。 |
| seed | integer | 42 | 0 到 2147483647 | 随机种子用于可重复的世代。 |
| preprocess_image | boolean | true | - | 去除背景并在生成前对参考图像进行归一化。 |
| max_num_tokens | integer | 49152 | 1024 到 131072 | 用于级联生成的最大稀疏令牌。 |
| ss_sampling_steps | integer | 12 | 1 到 64 | 稀疏结构生成的采样步骤。 |
| ss_guidance_strength | number | 7.5 | 0 到 20 | 稀疏结构生成的导引强度。 |
| ss_guidance_rescale | number | 0.7 | 0 到 2 | 为稀疏结构生成提供引导重标。 |
| ss_guidance_interval_start | number | 0.6 | 0 到 1 | 稀疏结构引导区间的开始。 |
| ss_guidance_interval_end | number | 1 | 0 到 1 | 稀疏结构指导区间结束。 |
| ss_rescale_t | number | 5 | 0 到 20 | 重新调整温度以实现稀疏结构生成。 |
| shape_slat_sampling_steps | integer | 12 | 1 到 64 | 形状结构化潜在生成的采样步骤。 |
| shape_slat_guidance_strength | number | 7.5 | 0 到 20 | 形状结构潜生成的指导强度。 |
过失 - 1024级级联管道 - 每阶段12个采样器步骤 - 2048个纹理尺寸 - 500k 毁灭目标 - GLB输出 控制 支持图像 URL 或上传, 512/1024 /1536 分辨率,种子,管道类型,采样器 guidance/interval / 缩放控制,纹理大小,网格断裂,重映,紫外线解围调和,以及 URL 或碱基64 输出. 按生成的立体资产计费。
在 EmpirioLabs，TRELLIS.2 4B 按量计费。本页的实时价格表始终与 API 的实际计费一致。
TRELLIS.2 4B 通过 api.empiriolabs.ai 上的 POST /v1/3d/generations 提供，使用标准的 Bearer 令牌认证。
可以。EmpirioLabs Playground在浏览器中以与 API 相同的参数运行 TRELLIS.2 4B，你可以在写代码之前先测试提示词。
创建 EmpirioLabs 账户，然后在控制台的 API Keys生成密钥。计费使用按量付费的额度，只为实际发出的请求付费。