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 ด้วยคีย์ API เดียวกัน อัปโหลดไฟล์ของคุณไปยัง upload_url ที่ได้รับ จากนั้นส่ง download_url ใน job_spec (เช่น เป็น 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 | รันโมเดล segmentation เมื่อภาพไม่มีความโปร่งใสในตัว ปิดตัวเลือกนี้หากภาพเป็นภาพตัดที่สะอาดบนพื้นขาวอยู่แล้ว หรือเมื่อตัวแบบเต็มเฟรม |
steps | ไม่ | 50 | ขั้นตอน Rectified-flow ต่ำกว่าประมาณ 16 รูปทรงยังจำได้แต่สูญเสียรายละเอียดนูนละเอียด สูงกว่าค่าเริ่มต้นแล้วจะไม่เปลี่ยนอีก |
guidance_scale | ไม่ | 7 | ระดับที่เมชทำตามภาพอ้างอิง |
seed | ไม่ | — | ซีดสุ่มเพื่อให้สร้างภาพซ้ำได้ |
grid_resolution | ไม่ | 192 | ความละเอียดของฟิลด์ที่ใช้สกัดพื้นผิว ต้นทุนเพิ่มตามกำลังสาม: 256 ใช้งานมากกว่าค่าเริ่มต้นราว 2.4 เท่า สำหรับความต่างที่ส่วนใหญ่ไม่รอดหลังการปรับให้เรียบ |
texture | ไม่ | true | ฉายภาพถ่ายลงบนเมชเป็นเท็กซ์เจอร์สีฐาน ด้านที่ภาพถ่ายแสดงจะคมชัด ด้านไกลเป็นรอยเลอะของสีเงาที่ใกล้ที่สุด เพราะภาพเดียวมองไม่เห็นด้านนั้น ปิดเพื่อให้ได้เมชสีเทาเปล่า — ไฟล์เล็กกว่า และเหมาะหากคุณจะทำเท็กซ์เจอร์เอง |
texture_upscale | ไม่ | false | รัน super-resolution 4x บนตัวแบบก่อนฉาย คุ้มเฉพาะเมื่อตัวแบบเล็กในเฟรม — เท็กซ์เจอร์ถูกสร้างที่ความละเอียดของภาพถ่ายเอง ภาพที่ใหญ่และชัดจึงมีรายละเอียดมากกว่าที่เท็กซ์เจอร์รับได้อยู่แล้ว และตัวเลือกนี้จะเป็นเพียงการขยายสิ่งที่เราย่อไว้เอง ระบบจะข้ามให้อัตโนมัติเมื่อภาพใหญ่พอ การเปิดไว้จึงไม่เสียอะไรนอกจากการดาวน์โหลด |
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) ตัวแบบจะถูกตัดออกจากพื้นหลัง สีมาจากภาพถ่าย ด้านที่ถ่ายจะคมชัด ด้านไกลจะนุ่มกว่า และไม่มี metallic หรือ roughness map แปลงภาพเป็น 3D ฟรีบนอุปกรณ์ที่คุณเชื่อมต่อ รวมถึงโทรศัพท์ การรันครั้งแรกจะดาวน์โหลดโมเดล ภาพถัดไปจะเริ่มได้เร็วขึ้น ตัวเลือกขั้นสูงใช้ปิดการตัดตัวแบบและเท็กซ์เจอร์ และเปิดเท็กซ์เจอร์ที่ใหญ่ขึ้นเมื่อตัวแบบเล็กเกินไปในเฟรม