תלת-ממד

TripoSG תמונה ל-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מריצים את מודל הסגמנטציה כשלתמונה אין שקיפות משלה. כבו אפשרות זו עבור תמונה שהיא כבר גזירה נקייה על רקע לבן, או כשהנושא ממלא את הפריים.
stepsלא50צעדי rectified-flow. מתחת לכ-16 הצורה ניתנת לזיהוי אך מאבדת תבליט עדין; מעל ברירת המחדל היא מפסיקה להשתנות.
guidance_scaleלא7עד כמה הרשת עוקבת אחר תמונת הייחוס.
seedלא—Seed אקראי ליצירה ניתנת לשחזור.
grid_resolutionלא192רזולוציית השדה שממנו מופק המשטח. העלות גדלה בחזקה שלישית: 256 הוא כ-2.4 פעמים העבודה של ברירת המחדל, עבור הבדל שברובו אינו שורד החלקה.
textureלאtrueהקרנת התמונה על הרשת כמרקם צבע בסיס. הצד שהתמונה הציגה יוצא חד; הצד הרחוק הוא מריחה של צבע ההיקף הקרוב ביותר, כי תמונה אחת אינה יכולה לראות אותו. כבו לקבלת רשת אפורה פשוטה — קובץ קטן יותר, והבחירה הנכונה אם אתם עומדים לצבוע אותה בעצמכם.
texture_upscaleלאfalseמריצים מעבר סופר-רזולוציה פי 4 על הנושא לפני ההקרנה. כדאי רק כשהנושא קטן בפריים — המרקם נבנה ברזולוציה של התמונה עצמה, ולכן לתמונה גדולה וברורה כבר יש יותר פרטים ממה שהוא מחזיק, וזה רק יגדיל את ההקטנה שלנו עצמנו. זה מדולג אוטומטית כשהתמונה גדולה מספיק, ולכן השארתו מופעל עולה רק בהורדה.
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>"
}

העלו תמונה אחת והורידו רשת תלת-ממדית (GLB). הנושא נחתך מהרקע. הצבע נלקח מהתמונה: הצד שצילמתם חד, הצד הרחוק רך יותר, ואין מפות מתכתיות או חספוס. המרת תמונה ל-3D בחינם במכשירים שחיברתם, כולל טלפון. בהרצה הראשונה המודל יורד; תמונות נוספות מתחילות מהר יותר. אפשרויות מתקדמות מכבות את החיתוך ואת המרקם, ומפעילות מרקם גדול יותר כשהנושא קטן מדי בפריים.