3D
TripoSG 图生 3D
把一张照片变成可下载的 3D 网格,手机上也能做到。
TripoSG by VAST-AI-Research; DINOv2 by Meta AI; U2-Net by Xuebin Qin and contributors; rembg by Daniel Gatis
Real-ESRGAN by Xintao Wang
4x-UltraSharp by Kim2091, CC BY-NC-SA 4.0; converted to ONNX by Mesh, unchanged learned tensors.
模型许可证
TripoSG DiT and VAE ONNX derivatives · MIT
Preserve the complete MIT terms, copyright notice and disclaimer, and identify modifications. No upstream endorsement is granted.
DINOv2 Large conditioning image encoder · Apache-2.0
Preserve the complete Apache-2.0 terms, copyright notices and disclaimers, identify modifications, and respect Apache patent/trademark provisions. No upstream endorsement is granted.
U2-Net matte, rembg ONNX release · Apache-2.0 AND MIT
Preserve the complete applicable MIT/Apache-2.0 terms, copyright notices and disclaimers, identify modifications, and respect Apache patent/trademark provisions. No upstream endorsement is granted.
Real-ESRGAN x4plus original release ONNX derivative · BSD-3-Clause
Retain the original copyright notice, all three BSD conditions and warranty disclaimer with distributed copies. No endorsement using author/contributor names without permission.
Original 4x-UltraSharp ONNX conversion by Mesh · CC-BY-NC-SA-4.0
NonCommercial only. Preserve attribution, full license and modification notice. ShareAlike applies to adapted licensed material. Private compute only, unmetered, requester and operator acceptance required; no global-network execution. Acceptance does not grant commercial permission.
API 参考
通过 REST 提交
使用您的个人 API 密钥(msk_…),从您自己的工具为此工作负载创建任务。以这种方式启动的任务会在您于您的设备中连接的同一批设备上运行——至少需要有一台在线。
https://cp.meshlabs.cloud/v1/organizations/jobs使用 X-Organization-Api-Key: msk_your_personal_api_key 进行身份验证。该请求头名称与组织密钥相同;个人密钥使用相同的端点。
POST https://cp.meshlabs.cloud/v1/organizations/job-inputs/presign,将文件上传到返回的 upload_url,然后在 job_spec 中传入 download_url(例如作为 input_image_url)。请求体
{
"workload_type": "triposg-1-5b-i2m",
"job_spec": {
"input_image_url": "https://…/your-input.png",
"remove_background": true,
"steps": 50,
"guidance_scale": 7,
"grid_resolution": 192,
"texture": true,
"texture_upscale": false,
"texture_upscaler": "ultrasharp"
}
}job_spec 字段
| 字段 | 必填 | 默认值 | 说明 |
|---|---|---|---|
input_image_url | 是 | — | 单个物体的照片或渲染图。主体会被自动抠出、裁剪为正方形并缩放到 224x224,因此单个清晰的主体能得到最好的几何形状:杂乱的场景和多个物体会干扰抠图。已带透明度的 PNG 会跳过抠图步骤,是所有输入中最可靠的。 |
remove_background | 否 | true | 当图片本身没有透明度时,运行分割模型。如果图片已经是白底的干净抠图,或主体已充满画面,请关闭此项。 |
steps | 否 | 50 | 整流流步数。低于约 16 时形状依然可辨,但会丢失精细的浮雕细节;高于默认值后不再变化。 |
guidance_scale | 否 | 7 | 网格与参考图片的贴合程度。 |
seed | 否 | — | 用于可复现生成的随机种子。 |
grid_resolution | 否 | 192 | 提取表面所用场的分辨率。成本随立方增长:256 的工作量约为默认值的 2.4 倍,而带来的差异大多经不起平滑处理。 |
texture | 否 | true | 把照片作为基础色纹理投影到网格上。照片所展示的那一面会很清晰;背面是最近轮廓颜色的涂抹,因为一张图片看不到它。关闭则得到纯灰色网格:文件更小,如果您打算自己上纹理,这是正确的选择。 |
texture_upscale | 否 | false | 在投影之前,对主体运行一次 4 倍超分辨率处理。仅当主体在画面中较小时才值得:纹理是按照片自身的分辨率构建的,因此大而清晰的照片本身的细节已多于纹理所能容纳的,此时这样做只是对我们自己的缩小再做放大。当照片足够大时会自动跳过,所以开启它除了一次下载之外没有任何代价。 |
texture_upscaler | 否 | ultrasharp | UltraSharp: preferred detail, private NonCommercial use with terms acceptance. x4plus: BSD-3-Clause alternative. Used only when sharpening a small photo is enabled. |
cURL
curl -X POST https://cp.meshlabs.cloud/v1/organizations/jobs \
-H "X-Organization-Api-Key: msk_your_personal_api_key" \
-H "Content-Type: application/json" \
-d '{
"workload_type": "triposg-1-5b-i2m",
"job_spec": {
"input_image_url": "https://…/your-input.png",
"remove_background": true,
"steps": 50,
"guidance_scale": 7,
"grid_resolution": 192,
"texture": true,
"texture_upscale": false,
"texture_upscaler": "ultrasharp"
}
}'https://cp.meshlabs.cloud/v1/organizations/jobs/{job_id}使用同一 API 密钥轮询,直到 status 进入终态(COMPLETED、FAILED、CANCELED 或 MODERATION_BLOCKED)。启用内容审核时,任务可能会先处于 MODERATION_PENDING 状态,然后才进入计算队列。已完成的任务会在每个输出上包含预签名的 download_url 值。
创建响应
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"workload_type": "triposg-1-5b-i2m",
"status": "PENDING",
"job_spec_json": {
"input_image_url": "https://…/your-input.png",
"remove_background": true,
"steps": 50,
"guidance_scale": 7,
"grid_resolution": 192,
"texture": true,
"texture_upscale": false,
"texture_upscaler": "ultrasharp"
},
"work_units": [],
"outputs": [],
"created_at": "2026-06-08T12:00:00Z",
"updated_at": "2026-06-08T12:00:00Z"
}完成响应
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"workload_type": "triposg-1-5b-i2m",
"status": "COMPLETED",
"job_spec_json": {
"input_image_url": "https://…/your-input.png",
"remove_background": true,
"steps": 50,
"guidance_scale": 7,
"grid_resolution": 192,
"texture": true,
"texture_upscale": false,
"texture_upscaler": "ultrasharp"
},
"work_units": [
{
"id": "…",
"index": 0,
"status": "COMPLETED"
}
],
"outputs": [
{
"id": "…",
"output_type": "<output type>",
"filename": "<output filename>",
"size_bytes": 524288,
"download_url": "<presigned output download URL>"
}
],
"created_at": "2026-06-08T12:00:00Z",
"updated_at": "<completion timestamp>"
}上传一张照片,下载 3D 网格(GLB)。主体会从背景中抠出。颜色来自照片:您拍摄的那一面很清晰,背面较柔和,没有金属度或粗糙度贴图。在您连接的设备上免费图生 3D,手机也可以。首次运行会下载模型;之后的照片启动更快。高级选项可以关闭抠图和纹理,并在主体在画面中太小时开启更大的纹理。