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.

ใบอนุญาตที่แนบมา

ประกาศ

ฟรีออนไลน์ไม่จำกัดUltraSharp การเข้าถึง API

เอกสารอ้างอิง API

ส่งผ่าน REST

ใช้คีย์ API ส่วนบุคคลของคุณ (msk_…) เพื่อสร้างงานสำหรับเวิร์กโหลดนี้จากเครื่องมือของคุณเอง งานที่เริ่มด้วยวิธีนี้จะทำงานบนอุปกรณ์เดียวกับที่คุณเชื่อมต่อไว้ใน อุปกรณ์ของคุณ — ต้องมีอย่างน้อยหนึ่งเครื่องที่ออนไลน์

ซ่อนรายละเอียด API
POSThttps://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ไม่ultrasharpUltraSharp: 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"
  }
}'
GEThttps://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 ฟรีบนอุปกรณ์ที่คุณเชื่อมต่อ รวมถึงโทรศัพท์ การรันครั้งแรกจะดาวน์โหลดโมเดล ภาพถัดไปจะเริ่มได้เร็วขึ้น ตัวเลือกขั้นสูงใช้ปิดการตัดตัวแบบและเท็กซ์เจอร์ และเปิดเท็กซ์เจอร์ที่ใหญ่ขึ้นเมื่อตัวแบบเล็กเกินไปในเฟรม