3D
TripoSG Chuyển ảnh thành 3D
Biến một bức ảnh thành lưới 3D có thể tải về, kể cả trên điện thoại.
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.
Giấy phép mô hình
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.
Tài liệu tham khảo API
Gửi qua REST
Dùng khóa API cá nhân của bạn (msk_…) để tạo tác vụ cho workload này từ công cụ của riêng bạn. Tác vụ khởi chạy theo cách này chạy trên chính các thiết bị bạn đã kết nối tại Thiết bị của bạn — ít nhất một thiết bị phải trực tuyến.
https://cp.meshlabs.cloud/v1/organizations/jobsXác thực bằng X-Organization-Api-Key: msk_your_personal_api_key. Tên header giống với khóa tổ chức; khóa cá nhân dùng cùng endpoint.
POST https://cp.meshlabs.cloud/v1/organizations/job-inputs/presign với cùng khóa API, tải tệp của bạn lên upload_url được trả về, rồi truyền download_url trong job_spec (ví dụ dưới dạng input_image_url).Nội dung yêu cầu
{
"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"
}
}Các trường của job_spec
| Trường | Bắt buộc | Mặc định | Mô tả |
|---|---|---|---|
input_image_url | Có | — | Ảnh chụp hoặc ảnh dựng của một vật thể đơn lẻ. Chủ thể được tự động tách nền, cắt vuông và đổi kích thước thành 224x224, nên một chủ thể đơn lẻ rõ ràng cho hình học tốt nhất — cảnh phức tạp và nhiều vật thể làm bước tách nền nhầm lẫn. Ảnh PNG đã có sẵn độ trong suốt sẽ bỏ qua bước tách nền và là đầu vào đáng tin cậy nhất. |
remove_background | Không | true | Chạy mô hình phân đoạn khi ảnh không có sẵn độ trong suốt. Tắt tùy chọn này với ảnh đã là bản cắt sạch trên nền trắng, hoặc khi chủ thể lấp đầy khung hình. |
steps | Không | 50 | Số bước rectified-flow. Dưới khoảng 16 hình dạng vẫn nhận ra được nhưng mất các chi tiết nổi nhỏ; trên mặc định thì không còn thay đổi. |
guidance_scale | Không | 7 | Mức độ lưới bám sát ảnh tham chiếu. |
seed | Không | — | Seed ngẫu nhiên để tạo ảnh có thể tái lập. |
grid_resolution | Không | 192 | Độ phân giải của trường mà bề mặt được trích xuất từ đó. Chi phí tăng theo lập phương: 256 tốn công gấp khoảng 2.4 lần mặc định cho sự khác biệt phần lớn không còn sau khi làm mịn. |
texture | Không | true | Chiếu ảnh lên lưới làm kết cấu màu cơ bản. Mặt mà ảnh thể hiện thì sắc nét; mặt xa là vệt nhòe của màu viền bóng gần nhất, vì một ảnh không thể nhìn thấy nó. Tắt để có lưới xám trơn — tệp nhỏ hơn, và là lựa chọn đúng nếu bạn tự tạo kết cấu. |
texture_upscale | Không | false | Chạy một lượt siêu phân giải 4x trên chủ thể trước khi chiếu. Chỉ đáng dùng khi chủ thể nhỏ trong khung hình — kết cấu được dựng ở độ phân giải gốc của ảnh, nên ảnh lớn, rõ đã có nhiều chi tiết hơn mức nó chứa và việc này chỉ phóng to phần chúng tôi đã thu nhỏ. Bước này tự động bị bỏ qua khi ảnh đủ lớn, nên để bật chỉ tốn thêm một lượt tải. |
texture_upscaler | Không | 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}Thăm dò bằng cùng khóa API cho đến khi status ở trạng thái kết thúc (COMPLETED, FAILED, CANCELED hoặc MODERATION_BLOCKED). Khi kiểm duyệt nội dung được bật, tác vụ có thể bắt đầu ở MODERATION_PENDING trước khi vào hàng đợi tính toán. Tác vụ đã hoàn tất có các giá trị download_url được ký trước trên mỗi đầu ra.
Phản hồi khi tạo
{
"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"
}Phản hồi khi hoàn tất
{
"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>"
}Tải lên một bức ảnh và tải về lưới 3D (GLB). Chủ thể được tách khỏi nền. Màu sắc lấy từ ảnh: mặt bạn chụp thì sắc nét, mặt xa mềm hơn, và không có bản đồ kim loại hay độ nhám. Chuyển ảnh thành 3D miễn phí trên các thiết bị bạn kết nối, kể cả điện thoại. Lần chạy đầu tiên sẽ tải mô hình về; các ảnh sau sẽ bắt đầu nhanh hơn. Tùy chọn nâng cao cho phép tắt tách nền và kết cấu, và bật kết cấu lớn hơn khi chủ thể quá nhỏ trong khung hình.