跳转到内容

Trellis 2

集成

模型 id trellis-2
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/trellis-2?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

此请求: $0.30 300 API 积分 在此页面运行

获取 API 密钥
Microsoft 图像转 3D #image-to-3d

将单张图像转换为带纹理的 GLB 3D 网格,可调节结构、形状、纹理和 UV 设置

Microsoft · 3D

你的第一个结果将在此显示

在下方构建请求,并使用你的 API 密钥运行。输出会复制到我们的存储中,可永久保存或免费保存 7 天。

构建请求

控件根据模型架构生成。更改控件时,代码和价格会同步更新。

•必填 image_url
拖放文件,或

指向用于 3D 转换的源图像的 URL。

resolution 默认 1024

输出分辨率;提高分辨率会增加细节,但耗时更长。

高级 texture_size · ss_guidance_strength · ss_guidance_rescale · ss_guidance_interval_start · ss_guidance_interval_end · ss_sampling_steps · ss_rescale_t · shape_slat_guidance_strength · shape_slat_guidance_rescale · shape_slat_guidance_interval_start · shape_slat_guidance_interval_end · shape_slat_sampling_steps · shape_slat_rescale_t · tex_slat_guidance_strength · tex_slat_guidance_rescale · tex_slat_guidance_interval_start · tex_slat_guidance_interval_end · tex_slat_sampling_steps · tex_slat_rescale_t · decimation_target · remesh_band · remesh_project · uv_unwrap_angle_threshold_deg · uv_unwrap_refine_iterations · uv_unwrap_global_iterations · uv_unwrap_smooth_strength · seed · remesh
texture_size 默认 2048

用于烘焙的网格纹理分辨率。提高分辨率可获得更精细的表面细节,但会生成更大的文件。

默认 7.5

初始 3D 结构保真度控制:提高该值可更贴近输入图像,但可能增加噪声。

默认 0.7

第 1 阶段的引导伪影控制:较低设置会产生更强的引导效果,较高设置会带来更稳定的输出。

默认 0.6

阶段 1(稀疏结构)无分类器指导窗口的起始边界,以降噪比例表示。值越低,指导开始越早;只有 interval_start 到 interval_end 的区间使用指导,其他部分不使用指导。

默认 1

阶段 1(稀疏结构)的指导截止点:选择不小于 ss_guidance_interval_start 的值。该值表示无分类器指导停止时达到的降噪比例。

默认 12

初始结构去噪步数:增加步数可能提升质量,但会降低处理速度。

默认 5

通过结构生成噪声调度设置过渡锐度:提高该值会使过渡更锐利。

默认 7.5

详细几何保真度控制:提高对输入图像的遵循程度会增加细节,但也可能增加噪声。

默认 0.5

当几何结构出现噪声时提高此设置:它会减少形状阶段强引导造成的伪影。

默认 0.6

阶段 2 形状细化的无分类器指导启用点。该值表示降噪进度的比例,并设置 interval_start;指导仅在由 interval_start 和 interval_end 界定的窗口内运行。

默认 1

阶段 2(形状细化)的指导截止点:选择不小于 shape_slat_guidance_interval_start 的值。该值表示无分类器指导停止时达到的降噪比例。

默认 12

形状细化去噪步数:增加步数可能使几何结构更平滑,但会牺牲速度。

默认 3

通过形状细化噪声调度设置几何细节锐度;提高该值会产生更锐利的细节。

默认 1

纹理颜色保真度控制:较高设置会更贴近输入图像的颜色并提高鲜艳度,但可能导致过度饱和。

默认 0

提高此设置以处理噪声纹理或色带:它会减少纹理阶段强引导造成的伪影。

默认 0.6

阶段 3 纹理生成的无分类器指导启用点。该值表示降噪进度的比例,并设置 interval_start;指导仅在由 interval_start 和 interval_end 界定的窗口内运行。

默认 0.9

阶段 3(纹理)的指导截止点:选择不小于 tex_slat_guidance_interval_start 的值。该值表示无分类器指导停止时达到的降噪比例。

默认 12

用于生成纹理的去噪步数。增加步数会延长处理时间,但可能产生更干净的纹理。

默认 3

通过纹理生成噪声调度设置纹理细节锐度;提高该值会产生更锐利的细节。

默认 500000

网格顶点数目标值,通用场景推荐 500k,网页或移动设备推荐 20k–50k。降低目标值会以网格细节换取更小的文件。

默认 1

重新网格化移动容差:提高此值时,额外平滑可能会牺牲精细细节。此设置限制相对于原始表面的顶点位移。

默认 0

将重新网格化后的顶点投影回原始表面的强度:1 表示完全投影以保留细节,0 表示关闭投影以获得更平滑的结果。

默认 90

UV 图表角度限制,单位为度,用于限制一个图表内相邻面法线之间的差异。提高限制值倾向于生成更少、更大的图表,但可能产生拉伸;降低限制值倾向于生成更多图表并减少失真。

默认 0

用于计算 UV 图表的局部细化遍数。

默认 1

增加用于计算图表的全局聚类遍数,可改善 UV 图表平衡。

默认 1

调整 UV 图表边缘的平滑程度;较高设置可减少可见接缝,但存在 UV 失真的风险。

用于可复现随机生成的种子。

POST /run/trellis-2?wait=20 报价 → $0.30
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/trellis-2?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

运行此请求

你的密钥会保留在此浏览器中:仅发送到 Doitong API;只有勾选“记住”后才会保存到 localStorage。 获取 API 密钥

关于 Trellis 2

根据一张图像(`image_url`)构建 3D 资产并返回 GLB 文件。`resolution` 为 512、1024 或 1536,`texture_size` 为 1024、2048 或 4096。三个阶段(结构、形状、纹理)分别具有独立的引导和采样步数控制。`decimation_target` 设置网格顶点数(5,000 到 2,000,000),并提供重新网格化和 UV 展开选项。

参数

发送规范名称或原生名称之一,不要同时发送两者。 规范名称

名称类型 默认值允许值 描述
seed可选
类型integer | null
用于可复现随机生成的种子。
resolution可选
类型enum
默认值1024
51210241536
输出分辨率;提高分辨率会增加细节,但耗时更长。
ss_guidance_strength可选
类型number
默认值7.5
0 – 10
初始 3D 结构保真度控制:提高该值可更贴近输入图像,但可能增加噪声。
ss_guidance_rescale可选
类型number
默认值0.7
0 – 1
第 1 阶段的引导伪影控制:较低设置会产生更强的引导效果,较高设置会带来更稳定的输出。
ss_guidance_interval_start可选
类型number
默认值0.6
0 – 1
阶段 1(稀疏结构)无分类器指导窗口的起始边界,以降噪比例表示。值越低,指导开始越早;只有 interval_start 到 interval_end 的区间使用指导,其他部分不使用指导。
ss_guidance_interval_end可选
类型number
默认值1
0 – 1
阶段 1(稀疏结构)的指导截止点:选择不小于 ss_guidance_interval_start 的值。该值表示无分类器指导停止时达到的降噪比例。
ss_sampling_steps可选
类型integer
默认值12
1 – 50
初始结构去噪步数:增加步数可能提升质量,但会降低处理速度。
ss_rescale_t可选
类型number
默认值5
1 – 6
通过结构生成噪声调度设置过渡锐度:提高该值会使过渡更锐利。
shape_slat_guidance_strength可选
类型number
默认值7.5
0 – 10
详细几何保真度控制:提高对输入图像的遵循程度会增加细节,但也可能增加噪声。
shape_slat_guidance_rescale可选
类型number
默认值0.5
0 – 1
当几何结构出现噪声时提高此设置:它会减少形状阶段强引导造成的伪影。
shape_slat_guidance_interval_start可选
类型number
默认值0.6
0 – 1
阶段 2 形状细化的无分类器指导启用点。该值表示降噪进度的比例,并设置 interval_start;指导仅在由 interval_start 和 interval_end 界定的窗口内运行。
shape_slat_guidance_interval_end可选
类型number
默认值1
0 – 1
阶段 2(形状细化)的指导截止点:选择不小于 shape_slat_guidance_interval_start 的值。该值表示无分类器指导停止时达到的降噪比例。
shape_slat_sampling_steps可选
类型integer
默认值12
1 – 50
形状细化去噪步数:增加步数可能使几何结构更平滑,但会牺牲速度。
shape_slat_rescale_t可选
类型number
默认值3
1 – 6
通过形状细化噪声调度设置几何细节锐度;提高该值会产生更锐利的细节。
tex_slat_guidance_strength可选
类型number
默认值1
0 – 10
纹理颜色保真度控制:较高设置会更贴近输入图像的颜色并提高鲜艳度,但可能导致过度饱和。
tex_slat_guidance_rescale可选
类型number
默认值0
0 – 1
提高此设置以处理噪声纹理或色带:它会减少纹理阶段强引导造成的伪影。
tex_slat_guidance_interval_start可选
类型number
默认值0.6
0 – 1
阶段 3 纹理生成的无分类器指导启用点。该值表示降噪进度的比例,并设置 interval_start;指导仅在由 interval_start 和 interval_end 界定的窗口内运行。
tex_slat_guidance_interval_end可选
类型number
默认值0.9
0 – 1
阶段 3(纹理)的指导截止点:选择不小于 tex_slat_guidance_interval_start 的值。该值表示无分类器指导停止时达到的降噪比例。
tex_slat_sampling_steps可选
类型integer
默认值12
1 – 50
用于生成纹理的去噪步数。增加步数会延长处理时间,但可能产生更干净的纹理。
tex_slat_rescale_t可选
类型number
默认值3
1 – 6
通过纹理生成噪声调度设置纹理细节锐度;提高该值会产生更锐利的细节。
decimation_target可选
类型integer
默认值500000
5,000 – 2,000,000
网格顶点数目标值,通用场景推荐 500k,网页或移动设备推荐 20k–50k。降低目标值会以网格细节换取更小的文件。
texture_size可选
类型enum
默认值2048
102420484096
用于烘焙的网格纹理分辨率。提高分辨率可获得更精细的表面细节,但会生成更大的文件。
remesh可选
类型boolean
默认值true
重建拓扑以创建更整洁的网格三角形,通常会提高后续动画或 3D 打印等用途的适用性,但处理速度会降低。
remesh_band可选
类型number
默认值1
0 – 4
重新网格化移动容差:提高此值时,额外平滑可能会牺牲精细细节。此设置限制相对于原始表面的顶点位移。
remesh_project可选
类型number
默认值0
0 – 1
将重新网格化后的顶点投影回原始表面的强度:1 表示完全投影以保留细节,0 表示关闭投影以获得更平滑的结果。
uv_unwrap_angle_threshold_deg可选
类型number
默认值90
0 – 180
UV 图表角度限制,单位为度,用于限制一个图表内相邻面法线之间的差异。提高限制值倾向于生成更少、更大的图表,但可能产生拉伸;降低限制值倾向于生成更多图表并减少失真。
uv_unwrap_refine_iterations可选
类型integer
默认值0
0 – 10
用于计算 UV 图表的局部细化遍数。
uv_unwrap_global_iterations可选
类型integer
默认值1
1 – 10
增加用于计算图表的全局聚类遍数,可改善 UV 图表平衡。
uv_unwrap_smooth_strength可选
类型number
默认值1
0 – 10
调整 UV 图表边缘的平滑程度;较高设置可减少可见接缝,但存在 UV 失真的风险。
image_url必填 image
类型url · image
指向用于 3D 转换的源图像的 URL。
必填 规范名称,也可接受

文件参数接受公开的 https:// URL、最大 10 MB 的 data: URI,或上传文件的 file_url。 文件

输出

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "trellis-2",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 300,
    "usd": "0.30",
    "charged": 300,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "model_glb": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
你的文件,由你选择每个 outputs[].url 都是存储中的副本:可永久保存(按 GB-月付费),也可免费保存 7 天,由账户设置或 ?storage= 决定。
每个模型的结构相同图像、视频和音频均包含 type、url、content_type、width、height 和 duration。output 是模型自身的结果对象。
输出字段
model_glb
object {url, content_type, file_name, file_size}以 GLB 格式生成的 3D 模型。

更多模型:图像转 3D

对于 AI 代理:此页面的 Markdown 版本位于 https://doitong.com/zh/developers/models/trellis-2.md. 所有模型和指南: https://doitong.com/developers/llms.txt