3D
TripoSG Gambar ke 3D
Ubah satu foto menjadi mesh 3D yang dapat diunduh, termasuk di ponsel.
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.
Lisensi model
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.
Referensi API
Kirim melalui REST
Gunakan kunci API pribadi Anda (msk_…) untuk membuat tugas bagi beban kerja ini dari alat Anda sendiri. Tugas yang dimulai dengan cara ini berjalan di perangkat yang sama yang Anda hubungkan di Perangkat Anda — setidaknya satu harus online.
https://cp.meshlabs.cloud/v1/organizations/jobsAutentikasi dengan X-Organization-Api-Key: msk_your_personal_api_key. Nama header sama dengan kunci organisasi; kunci pribadi menggunakan endpoint yang sama.
POST https://cp.meshlabs.cloud/v1/organizations/job-inputs/presign dengan kunci API yang sama, unggah file Anda ke upload_url yang dikembalikan, lalu teruskan download_url di job_spec (misalnya sebagai input_image_url).Isi permintaan
{
"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"
}
}Kolom job_spec
| Kolom | Wajib | Default | Deskripsi |
|---|---|---|---|
input_image_url | Ya | — | Foto atau render satu objek. Subjek dipotong secara otomatis, dipotong persegi dan diubah ukurannya menjadi 224x224, sehingga satu subjek yang jelas memberikan geometri terbaik — adegan ramai dan beberapa objek membingungkan pemotongan. PNG yang sudah transparan melewati langkah pemotongan dan merupakan input paling andal. |
remove_background | Tidak | true | Jalankan model segmentasi jika gambar tidak memiliki transparansi sendiri. Matikan untuk gambar yang sudah berupa potongan bersih di atas putih, atau saat subjek memenuhi bingkai. |
steps | Tidak | 50 | Langkah rectified-flow. Di bawah sekitar 16 bentuk masih dapat dikenali tetapi kehilangan relief halus; di atas default tidak lagi berubah. |
guidance_scale | Tidak | 7 | Seberapa ketat mesh mengikuti gambar referensi. |
seed | Tidak | — | Random seed untuk pembuatan yang dapat direproduksi. |
grid_resolution | Tidak | 192 | Resolusi medan tempat permukaan diekstrak. Biaya tumbuh dengan pangkat tiga: 256 kira-kira 2.4x pekerjaan default untuk perbedaan yang sebagian besar tidak bertahan setelah smoothing. |
texture | Tidak | true | Proyeksikan foto ke mesh sebagai tekstur warna dasar. Sisi yang terlihat pada foto tampil tajam; sisi jauh adalah olesan warna siluet terdekat, karena satu gambar tidak dapat melihatnya. Matikan untuk mesh abu-abu polos — file lebih kecil, dan pilihan yang tepat jika Anda akan menekstur sendiri. |
texture_upscale | Tidak | false | Jalankan lintasan super-resolusi 4x pada subjek sebelum memproyeksikannya. Hanya berguna jika subjek kecil dalam bingkai — tekstur dibangun pada resolusi foto itu sendiri, sehingga foto besar yang jelas sudah memiliki lebih banyak detail daripada yang dipegangnya dan ini hanya akan meng-upscale downscale kita sendiri. Dilewati otomatis jika foto cukup besar, sehingga membiarkannya aktif tidak memakan biaya selain unduhan. |
texture_upscaler | Tidak | 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}Lakukan polling dengan kunci API yang sama sampai status mencapai status akhir (COMPLETED, FAILED, CANCELED, atau MODERATION_BLOCKED). Jika moderasi konten diaktifkan, tugas dapat dimulai dalam status MODERATION_PENDING sebelum masuk ke antrean komputasi. Tugas yang selesai menyertakan nilai download_url presigned pada setiap keluaran.
Respons pembuatan
{
"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"
}Respons selesai
{
"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>"
}Unggah satu foto dan unduh mesh 3D (GLB). Subjek dipotong dari latar belakang. Warna berasal dari foto: sisi yang Anda foto tajam, sisi jauhnya lebih lembut, dan tidak ada peta metallic atau roughness. Gambar ke 3D gratis di perangkat yang Anda hubungkan, termasuk ponsel. Saat pertama dijalankan, model diunduh; foto berikutnya dimulai lebih cepat. Opsi lanjutan mematikan pemotongan dan tekstur, dan menyalakan tekstur yang lebih besar jika subjek terlalu kecil dalam bingkai.